SYSCALLS/GPR - graphics primitives calls 1987/01/22
Include files:
C: /sys/ins/gpr.ins.c
Fortran: /sys/ins/gpr.ins.ftn
Pascal: /sys/ins/gpr.ins.pas
Procedures and Functions:
unobscured := GPR_$ACQUIRE_DISPLAY (status)
Establishes exclusive access to the display hardware and the
display driver.
GPR_$ADDITIVE_BLT (source_bitmap_desc, source_window, source_plane,
dest_origin, status)
Transfers a single plane of any bitmap to all active planes of
the current bitmap.
GPR_$ALLOCATE_ATTRIBUTE_BLOCK (attrib_block_desc, status)
Allocates a data structure that contains a set of default
bitmap attribute settings, and returns the descriptor for the
data structure.
GPR_$ALLOCATE_BITMAP (size, hi_plane_id, attrib_block_desc, bitmap_desc,
status)
Allocates a bitmap in main memory and returns a bitmap descriptor.
GPR_$ALLOCATE_BITMAP_NC (size,hi_plane_id,attrib_block_desc,bitmap_desc,
status)
Allocates a bitmap in main memory without setting
all the pixels in the bitmap to zero, and returns
a bitmap descriptor.
GPR_$ALLOCATE_HDM_BITMAP (size, hi_plane_id, attrib_block_desc, bitmap_desc,
status)
Allocates a bitmap in hidden display memory.
GPR_$ARC_3P (point_2, point_3, status)
Draws an arc from the current position through two other
specified points.
attrib_block_desc = GPR_$ATTRIBUTE_BLOCK (bitmap_desc, status)
Returns the descriptor of the attribute
block associated with the given bitmap.
GPR_$BIT_BLT (source_bitmap_desc, source_window, source_plane,
dest_origin, dest_plane, status)
Performs a bit block transfer from a single plane of
any bitmap to a single plane of the current bitmap.
GPR_$CIRCLE(center, radius, status)
Draws a circle with the specified radius around
the specified center point.
GPR_$CIRCLE_FILLED (center, radius, status)
Draws and fills a circle with the specified radius around
the specified center point.
GPR_$CLEAR (index, status)
Sets all pixels in the current bitmap to the given
color/intensity value.
GPR_$CLOSE_FILL_PGON (status)
Closes and fills the currently open polygon.
GPR_$CLOSE_RETURN_PGON (list_size, trapezoid_list, trapezoid_number,
status)
Closes the currently open polygon and returns
the list of trapezoids within its interior.
GPR_$CLOSE_RETURN_PGON_TRI (list_size, t_list, n_triangles, status)
Closes the currently open polygon and returns a list of triangles
within its interior.
GPR_$COLOR_ZOOM (xfactor, yfactor, status)
Sets the zoom scale factor for a color display.
unobscured := GPR_$COND_EVENT_WAIT (event_type, event_data, position,
status)
Returns information about the occurrence of any
event without entering a wait state.
GPR_$DEALLOCATE_ATTRIBUTE_BLOCK (attrib_block_desc, status)
Deallocates an attribute block allocated by
GPR_$ALLOCATE_ATTRIBUTE_BLOCK.
GPR_$DEALLOCATE_BITMAP (bitmap_desc, status)
Deallocates an allocated bitmap.
GPR_$DISABLE_INPUT (event_type, status)
Disables a previously enabled event type.
GPR_$DRAW_BOX (X1, Y1, X2, Y2, status)
Draws an unfilled box based on the coordinates of two
opposing corners.
GPR_$ENABLE_DIRECT_ACCESS (status)
Ensures completion of display hardware operations before
the program uses the pointer to access display memory.
GPR_$ENABLE_INPUT (event_type, key_set, status)
Enables an event type and a selected set of keys.
unobscured := GPR_$EVENT_WAIT (event_type, event_data, position, status)
Waits for an event.
GPR_$FORCE_RELEASE (acquire_count, status)
Releases the display regardless of how many
times it has previously been acquired.
GPR_$GET_EC (gpr_key, eventcount_pointer, status)
Returns the eventcount associated with a graphic event.
GPR_$INIT (op_mode, unit, size, hi_plane_id, init_bitmap_desc, status)
Initializes the graphics primitives package.
GPR_$INQ_BITMAP (bitmap_desc, status)
Returns the descriptor of the current bitmap.
GPR_$INQ_BITMAP_DIMENSIONS (bitmap_desc, size, hi_plane_id, status)
Returns the size and number of planes of a bitmap.
GPR_$INQ_BITMAP_POINTER (bitmap_desc, storage_ptr, storage_line_width,
status)
Returns a pointer to bitmap storage in virtual address space.
Also returns offset in memory from beginning of one scan line
to the next.
GPR_$INQ_BITMAP_POSITION(bitmap_desc,origin,status);
Returns the position of the upper left corner of the specified
bitmap. This is normally the screen position; although, it does
have some significance for main memory bitmaps.
GPR_$INQ_BM_BIT_OFFSET (bitmap_desc, offset, status)
Returns the bit offset that corresponds to the left edge of a
bitmap in virtual address space.
GPR_$INQ_BITMAP_FILE_COLOR_MAP (bitmap, start, entries, color, status)
Returns the specified entries from the external-bitmap color map.
GPR_$INQ_CHARACTER_WIDTH (font_id, character, width, status)
Returns the width of the specified character in the specified font.
GPR_$INQ_COLOR_MAP (start_index, n_entries, values, status)
Returns the current color map values.
GPR_$INQ_CONFIG (config, status)
Returns the current display configuration.
GPR_$INQ_CONSTRAINTS (window, active, plane_mask, status)
Returns the clipping window and plane mask used for the current
bitmap.
GPR_$INQ_COORDINATE_ORIGIN (origin, status)
Returns the x- and y-offsets added to all x- and y-coordinates
used as input to move, drawing, and BLT operations on the
current bitmap.
GPR_$INQ_CP (x, y, status)
Returns the current position in the current bitmap.
GPR_$INQ_CURSOR (curs_pat, curs_raster_op, active, position, origin,
status)
Returns information about the cursor.
GPR_$INQ_PGON_DECOMP_TECHNIQUE(decomp_technique,status)
Returns the mode which controls the algorithm used to decompose
and rasterize polygons.
GPR_$INQ_DISP_CHARACTERISTICS(op,unit_or_pad,disp_len,disp,disp_len_ret,
status)
Allows the application program to obtain a variety of information
about the nature of the actual display device or external bitmap
if the program is operating in no-display mode.
GPR_$INQ_DRAW_VALUE (index, status)
Returns the color/intensity value used for drawing lines.
GPR_$INQ_FILL_BACKGROUND_VALUE (index, status)
Returns the color/intensity value of the background used for
tile fills.
GPR_$INQ_FILL_PATTERN(pattern, scale, status)
Returns the fill pattern for the current bitmap.
GPR_$INQ_FILL_VALUE (index, status)
Returns the color/intensity value used to fill
circles, rectangles, triangles, and trapezoids.
GPR_$INQ_HORIZONTAL_SPACING (font_id, horizontal_spacing, status)
Returns the parameter for the width of spacing
between displayed characters for the specified font.
GPR_$INQ_IMAGING_FORMAT (format, status)
Returns the current imaging format.
GPR_$INQ_LINE_PATTERN (repeat, pattern, length, status)
Returns the pattern used in drawing lines.
GPR_$INQ_LINESTYLE (style, scale, status)
Returns information about the current line-style.
GPR_$INQ_RASTER_OP_PRIM_SET (prim_set, status)
Returns the primitive(s) which will be affected by the next
GPR_$SET_RASTER_OP call, or the primitive(s) for which
GPR_$INQ_RASTER_OP will return the current raster-op.
GPR_$INQ_RASTER_OPS (raster_op, status)
Returns the raster operation for the primitives (lines, fills,
and bit-block transfers) specified with GPR_$RASTER_OP_PRIM_SET.
GPR_$INQ_REFRESH_ENTRY (window_procedure, disp_mem_procedure, status)
Returns two pointers: one to the procedure which refreshes the
window; one to the procedure which refreshes hidden display memory.
GPR_$INQ_SPACE_SIZE (font_id, space_size, status)
Returns the width of the space to be displayed
when a character requested is not in the specified font.
GPR_$INQ_TEXT (font_id, direction, status)
Returns the text font and text path used for the current bitmap.
GPR_$INQ_TEXT_EXTENT (string, string_length, size, status)
Returns the x- and y-offsets a string spans when written by
GPR_$TEXT.
GPR_$INQ_TEXT_OFFSET (string, string_length, start, xy_end, status)
Returns the x- and y-offsets from the top left pixel
of a string to the origin of the string's first character.
This routine also returns the x- or y-offset to the pixel
which is the new current position after the text is written
with GPR_$TEXT.
GPR_$INQ_TEXT_PATH (direction, status)
Returns the direction for writing a line of text.
GPR_$INQ_TEXT_VALUES (text_value, text_bkgd_value, status)
Returns the text color/intensity value and the text background
color/intensity value used in the current bitmap.
GPR_$INQ_TRIANGLE_FILL_CRITERIA(fill_crit, status)
Returns the filling criteria used with polygons decomposed into
triangles.
GPR_$INQ_VIS_LIST (slots_available, slots_total, vis_list, status)
Returns a list of the visible sections of an obscured window.
GPR_$INQ_WINDOW_ID (character, status)
Returns the character that identifies the current bitmap's window.
GPR_$LINE (x,y, status)
Draws a line from the current position to the end point supplied.
The current position is updated to the end point.
GPR_$LOAD_FONT_FILE (pathname, pathname_length, font_id, status)
Loads a font from a file into the display's font storage area.
GPR_$MOVE (x, y, status)
Sets the current position to the given position.
GPR_$MULTILINE (x, y, npositions, status)
Draws a series of disconnected lines.
GPR_$MULTITRAPEZOID (trapezoid_list, trapezoid_number, status)
Draws and fills a list of trapezoids in the current bitmap.
GPR_$MULTITRIANGLE (t_list, n_triangles, status)
Draws and fills a list of triangles in the current bitmap.
GPR_$OPEN_BITMAP_FILE (access, filename, name_size, version, size, groups,
group_header, attributes, bitmap, created, status)
Opens a file for external storage of a bitmap.
GPR_$PGON_DECOMP_TECHNIQUE(decomp_technique,status)
Sets a mode which controls the algorithm used to decompose and
render polygons.
GPR_$PGON_POLYLINE (x, y, npositions, status)
Defines a series of line segments forming part of a polygon boundary.
GPR_$PIXEL_BLT (source_bitmap_desc, source_window, dest_origin, status)
Performs a pixel block transfer from any bitmap to the current
bitmap.
GPR_$POLYLINE (x, y, npositions, status)
Draws a series of connected lines: drawing begins at the current
position, draws to the first given coordinate position, then sets
the current position to the first given position. This is repeated
for all given positions.
GPR_$READ_PIXELS (source_window, pixel_array, status)
Reads the pixel values from a window of the current bitmap and
stores the values in a pixel array.
GPR_$RECTANGLE (rectangle, status)
Draws and fills a rectangle.
GPR_$RELEASE_DISPLAY (status)
Decrements a counter associated with the number of times a
display has been acquired.
GPR_$REMAP_COLOR_MEMORY (plane, status)
Defines the plane in color display memory for which a pointer will
be returned when using GPR_$INQ_BITMAP_POINTER. This allows a
single plane of color display memory to be accessed directly.
GPR_$REMAP_COLOR_MEMORY_1 (plane, status)
Defines the plane in hidden color display memory for which a pointer
is returned when GPR_INQ_BITMAP_POINTER is used. This allows direct
access to a single plane of color display memory.
GPR_$REPLICATE_FONT (font_id, repli_font_id, status)
Creates and loads a modifiable copy of a font.
GPR_$RASTER_OP_PRIM_SET (prim_set, status)
Specifies the primitive(s) which will be affected by the next
GPR_$SET_RASTER_OP call, or the primitive(s) for which
GPR_$INQ_RASTER_OP will return the current raster-op.
GPR_$SELECT_COLOR_FRAME (frame, status)
Selects whether frame 0 or frame 1 of color display memory is visible.
GPR_$SET_ACQ_TIME_OUT (timeout, status)
Establishes the length of time the display will be acquired.
GPR_$SET_ATTRIBUTE_BLOCK (attrib_block_desc, status)
Associates an attribute block with the current bitmap.
GPR_$SET_AUTO_REFRESH (auto_refresh, status)
Directs the Display Manager to refresh the window automatically.
GPR_$SET_BITMAP (bitmap_desc, status)
Establishes a bitmap as the current bitmap for subsequent operations.
GPR_$SET_BITMAP_DIMENSIONS (bitmap_desc, size, hi_plane_id, status)
Modifies the size and the number of planes of a bitmap.
GPR_$SET_BITMAP_FILE_COLOR_MAP (bitmap, start, entries, color, status)
Establishes new values for the external-bitmap color map.
GPR_$SET_CHARACTER_WIDTH (font_id, character, width, status)
Specifies the width of the specified character in the specified
font.
GPR_$SET_CLIP_WINDOW (window, status)
Changes the clipping window for the current bitmap.
GPR_$SET_CLIPPING_ACTIVE (active, status)
Enables/disables a clipping window for the current bitmap.
GPR_$SET_COLOR_MAP (start_index, n_entries, values, status)
Establishes new values for the color map.
GPR_$SET_COORDINATE_ORIGIN (origin, status)
Establishes x- and y-offsets to add to all x- and y-coordinates
used for move, draw, text, fill, and BLT operations on the
current bitmap.
GPR_$SET_CURSOR_ACTIVE (active, status)
Specifies whether the cursor is displayed.
GPR_$SET_CURSOR_ORIGIN (origin, status)
Defines one of the cursor's pixels as the cursor origin.
GPR_$SET_CURSOR_PATTERN (cursor_pattern, status)
Loads a cursor pattern.
GPR_$SET_CURSOR_POSITION (position, status)
Establishes a position on the screen for display of the cursor.
GPR_$SET_DRAW_VALUE (index, status)
Specifies the color/intensity value to use to draw lines.
GPR_$SET_FILL_BACKGROUND_VALUE (index, status)
Specifies the color/intensity value used for drawing the
background of tile fills.
GPR_$SET_FILL_PATTERN (pattern, scale, status)
Specifies the fill pattern used for the current bitmap.
GPR_$SET_FILL_VALUE (index, status)
Specifies the color/intensity value to use to fill
circles, rectangles, triangles, and trapezoids.
GPR_$SET_HORIZONTAL_SPACING (font_id, horizontal_spacing, status)
Specifies the parameter for horizontal spacing of
the specified font.
GPR_$SET_IMAGING_FORMAT (format, status)
Sets the imaging format of the color display.
GPR_$SET_INPUT_SID (stream_id, status)
Specifies the input pad from which graphics input is to be taken.
GPR_$SET_LINE_PATTERN (repeat_count, pattern, length, status)
Specifies the pattern to use in drawing lines.
GPR_$SET_LINESTYLE (style, scale, status)
Sets the line-style attribute of the current bitmap.
GPR_$SET_OBSCURED_OPT (if_obscured, status)
Establishes the action to be taken when a window to be acquired
is obscured.
GPR_$SET_PLANE_MASK (mask, status)
Establishes a plane mask for subsequent write operations.
GPR_$SET_RASTER_OP (plane_id, raster_op, status)
Specifies a raster operation for the primitives established with
GPR_$RASTER_OP_PRIM_SET.
GPR_$SET_REFRESH_ENTRY (window_procedure, disp_mem_procedure, status)
Specifies the entry points of application-supplied
procedures that refresh the displayed image in a direct window
and hidden display memory.
GPR_$SET_SPACE_SIZE (font_id, space_size, status)
Specifies the size of horizontal spacing
for the specified font.
GPR_$SET_TEXT_BACKGROUND_VALUE (index, status)
Specifies the color/intensity value to use for
text background.
GPR_$SET_TEXT_FONT (font_id, status)
Establishes a new font for subsequent text operations.
GPR_$SET_TEXT_PATH (direction, status)
Specifies the direction for writing a line of text.
GPR_$SET_TEXT_VALUE (index, status)
Specifies the color/intensity value to use for writing text.
GPR_$SET_TRIANGLE_FILL_CRITERIA(fill_crit, status)
Sets the filling criteria used with polygons that are rendered
directly (decomposition technique set to render exact) or
polygons that are decomposed into triangles before being rendered.
GPR_$SET_WINDOW_ID (character, status)
Establishes the character that identifies the current bitmap's
window.
GPR_$SPLINE_CUBIC_P (x, y, npositions, status)
Draws a parametric cubic spline through the control points.
GPR_$SPLINE_CUBIC_X (x, y, npositions, status)
Draws a cubic spline as a function of x through the
control points.
GPR_$SPLINE_CUBIC_Y (x, y, npositions, status)
Draws a cubic spline as a function of y through the
control points.
GPR_$START_PGON (x, y, status)
Defines the starting position of a polygon.
GPR_$TERMINATE (delete_display, status)
Terminates the graphics primitives package.
GPR_$TEXT (string, string_length, status)
Writes text to the current bitmap, beginning at the current position.
GPR_$TRAPEZOID (trapezoid, status)
Draws and fills a trapezoid.
GPR_$TRIANGLE (vertex_1, vertex_2, vertex_3, status)
Draws and fills a triangle.
GPR_$UNLOAD_FONT_FILE (font_id, status)
Unloads a font that has been loaded by GPR_$LOAD_FONT_FILE.
GPR_$WAIT_FRAME (status)
Waits for the current frame refresh cycle to end before
executing operations that modify the color display.
GPR_$WRITE_PIXELS (pixel_array, destination_window, status)
Writes the pixel values from a pixel array into a
window of the current bitmap.