SYSCALLS/GPR - graphics primitives calls 1985/04/30
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)
Adds a single plane of any bitmap to 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_$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_$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_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_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_LINESTYLE (style, scale, status)
Returns information about the current line-style.
GPR_$INQ_LINE_PATTERN (repeat, pattern, length, status)
Returns the pattern used in drawing lines.
GPR_$INQ_RASTER_OPS (raster_op, status)
Returns the raster operations for the current bitmap.
GPR_$SET_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
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_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_$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 polygons
into trapezoids.
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
will be returned when using GPR_INQ_BITMAP_POINTER. This allows a
single plane of color display memory to be accessed directly.
GPR_$REPLICATE_FONT (font_id, repli_font_id, status)
Creates and loads a modifiable copy of a font.
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_CHARACTER_WIDTH (font_id, character, width, status)
Specifies the width of the specified character in the specified
font.
GPR_$SET_CLIPPING_ACTIVE (active, status)
Enables/disables a clipping window for the current bitmap.
GPR_$SET_CLIP_WINDOW (window, status)
Changes the 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_LINESTYLE (style, scale, status)
Sets the line-style attribute of the current bitmap.
GPR_$SET_LINE_PATTERN (repeat_count, pattern, length, status)
Specifies the pattern to use in drawing lines.
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 both BLTs and lines.
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_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.