This chapter contains the subroutines that have been replaced by an extended version of the subroutine. The new extended subroutine performs the same function as was supported in prior releases, plus it does some additional function.
The subroutines found in this chapter will continue to be supported for compatibility; however, it is recommended that the new applications use the new extended version of the subroutine and that existing applications migrate over time to the new extended subroutines.
Under each subroutine in this chapter, there is a "Related Subroutine" section which contains the name of its new extended subroutine.
| GPCR (wsid, index, number, colors) |
Purpose
Use GPCR to set the specified color values starting at the specified color table entry of the workstation's default color table. The color values are interpreted according to the workstation's current color model.
The workstation's default color table may be either its rendering color table or its display color table. If its display color table is modifiable, then it is the default, otherwise the rendering color table is modifiable, and thus, the default. (Use the Inquire Color Facilities [ GPQCF] subroutine [page GPQCF - Inquire Color Facilities] to determine the characteristics of the workstation's color table)
If the color model is Hue-Saturation-Value (HSV), the first color component (hue) is specified as a fraction of the total range available (that is, zero to one is used to represent zero degrees to 360 degrees) If the second color component is zero, then the first color component is ignored.
Parameters
The array is assumed to be in row order, such as RED1, GREEN1, BLUE1, RED2, GREEN2, BLUE2, etc... .
Error Codes
Related Subroutines
RCP code
201329414 (X'0C000B06')