ARSCAM(3NCARG) | NCAR GRAPHICS | ARSCAM(3NCARG) |
ARSCAM - Scans an area map from left to right, extracting the definitions of all the areas defined by the area map and delivering them to a user-defined subroutine for processing.
CALL ARSCAM (MAP,XCS,YCS,MCS,IAI,IAG,MAI,APR)
#include <ncarg/ncargC.h>
void c_arscam (int *map, float *xcs, float *ycs, int mcs, int *iai, int *iag, int mai, int (*apr)(float *xcs, float *ycs, int *ncs, int *iai, int *iag, int *nai))
Note: As part of initializing the area map, ARINAM stores the dimension of MAP in MAP(1); therefore, the dimension does not have to be given as an argument in calls to ARSCAM.)
SUBROUTINE APR (XCS,YCS,NCS,IAI,IAG,NAI)
DIMENSION XCS(*),YCS(*),IAI(*),IAG(*)
(code to process the area defined by XCS, YCS, IAI, and IAG)
RETURN
END
Before executing the first call to APR, ARSCAM calls GETSET to retrieve the current user coordinates and then executes the statement:
CALL SET (VPL,VPR,VPB,VPT,VPL,VPR,VPB,VPT,1)
where VPL, VPR, VPB, and VPT are the viewport left, right, bottom, and top coordinates in NDCs.
This ensures correct results if the NDCs in XCS and YCS are used in calls to such routines as GFA and GPL, and it allows clipping at the edges of the viewport. APR may make its own SET call to achieve some other effect. Before returning control to the calling routine, ARSCAM calls SET again to restore the original mapping parameters.
The C-binding argument descriptions are the same as the FORTRAN argument descriptions.
Use the ncargex command to see the following relevant examples: cardb1, carfill, ccpcldm, ccpfil, ccplbam, ccpllb, ccplll, ccpllw, ccpscam, ccpvs, colcon, cmpfil, cmpgrp, cmpita, cmptit, cpex01, cpex02, cpex03, cpex04, cpex05, cpex07, cpex08, eezmpa, arex01, vvex01, tareas, tconpa, tezmpa, fcover, ffex00, fcirc, fsfsgfa, fsppoint.
To use ARSCAM or c_arscam, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
See the areas man page for a description of all Areas error messages and/or informational messages.
Online: areas, areas_params, ardbpa, ardrln, aredam, argeti, argetr, argtai, arinam, armvam, arpram, arseti, arsetr, ncarg_cbind
Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
March 1993 | UNIX |