Picture Datatype - Revision history

Admin: /* Version */

2024-04-18T09:51:44Z

Version

Admin: /* Tags */

2024-03-04T22:17:44Z

Admin at 21:27, 4 March 2024

2024-03-04T21:27:23Z

Admin at 16:30, 4 March 2024

2024-03-04T16:30:22Z

Admin at 16:21, 4 March 2024

2024-03-04T16:21:49Z

Admin: /* NOTES */

2024-03-04T16:17:02Z

NOTES

Admin: /* TAGS */

2024-03-04T16:16:43Z

Admin: /* METHODS */

2024-03-04T16:16:29Z

METHODS

Admin: /* picture.datatype */

2024-03-04T16:15:58Z

picture.datatype

Admin at 16:12, 4 March 2024

2024-03-04T16:12:19Z

@@ Line 7: / Line 7: @@
 There are two versions available:
-* V46.12 is part of the SystemV46 installation for the [[A600GS]]
+* V46.13 is part of the SystemV46 installation for the [[A600GS]]
-* V54.12 is part of the SystemV54 and [[Enhancer Software]] V2.3 installation
+* V54.13 is part of the SystemV54 and [[Enhancer Software]] V2.3 installation
 =Installation=

@@ Line 109: / Line 109: @@
 {| class="wikitable"
 !Tag ID
+!Type
 !Description
 |-

@@ Line 489: / Line 489: @@
 =picture_dtc/OM_DISPOSE=
   NAME
-     OM_DISPOSE -- Dispose an instance of a document class object.
+     OM_DISPOSE -- Dispose an instance of a picture object.
   SYNOPSIS
@@ Line 496: / Line 496: @@
   FUNCTION
-    Dispose of the specified document class object instance.
+    Dispose of the specified picture object instance.
   INPUTS
@@ Line 535: / Line 535: @@
 =picture_dtc/OM_NEW=
   NAME
-     OM_NEW -- Initialise a new instance of a document class object.
+     OM_NEW -- Initialise a new instance of a picture object.
   SYNOPSIS
@@ Line 542: / Line 542: @@
   FUNCTION
-    Initialise a new instance of a document class object and apply the
+    Initialise a new instance of a picture object and apply the
     attribute values specified.

← Older revision		Revision as of 16:30, 4 March 2024
Line 2:		Line 2:

	The '''picture.datatype''' is the root datatype class for pictures. It is the super-class for any picture related classes.		The '''picture.datatype''' is the root datatype class for pictures. It is the super-class for any picture related classes.
		+
		+	=Version=
		+
		+	There are two versions available:
		+
		+	* V46.12 is part of the SystemV46 installation for the [[A600GS]]
		+	* V54.12 is part of the SystemV54 and [[Enhancer Software]] V2.3 installation

	=Installation=		=Installation=

← Older revision		Revision as of 16:21, 4 March 2024
Line 2:		Line 2:

	The '''picture.datatype''' is the root datatype class for pictures. It is the super-class for any picture related classes.		The '''picture.datatype''' is the root datatype class for pictures. It is the super-class for any picture related classes.
		+
		+	=Installation=
		+
		+	{\|
		+	\|-
		+	\|[[File:Classes_Icon.png\|center]]
		+	\|Manual installation:
		+	Copy the file '''picture.datatype''' to '''SYS:Classes/Datatypes''' directory
		+
		+	\|}
		+
		+

	=Methods=		=Methods=

← Older revision		Revision as of 16:17, 4 March 2024
Line 289:		Line 289:


−	==~~NOTES~~==	+	==Notes==

	Contrary to previous versions of the picture.datatype, the PDTA_Allocated tag now returns the number of pens allocated during layout or remap. For the common use of the picture class, this value will be the same as that for PDTA_NumAlloc but where layout/remap has been performed without a screen, no pens can be allocated even though the (number of) colours in the destination bitmap may have been altered. Making a distinction between these two facets of the datatype allow remapping to be performed without intending to display the result; for example, simply reducing the colours or scaling a picture does not require a screen yet prior implementations require that it does. Anecdotally, I do not believe PDTA_AllocatedPens works as described in the "official" documentation since PDTA_ColorTable and PDTA_ColorTable2 are described as having potentially different pens; so when this occurs, the documented nature of a 1:1 mapping of PDTA_GRegs to PDTA_AllocatedPens is evidently false because there are two potential pens for one colour map entry with no way to distinguish those in the PDTA_AllocatedPens series. If the number of colours for a colour-mapped picture is limited to 256 (8-bit) then PDTA_NumAlloc can never be higher than this, leading to the values in PDTA_AllocatedPens only list half of the actual pens allocated. Plus, the values of PDTA_AllocatedPens do not match the palette entry when this occurs. Therefore, PDTA_NumColors is to PDTA_CRegs as PDTA_NumAlloc is to PDTA_GRegs. Thus, PDTA_Allocated shares this same relationship to PDTA_AllocatedPens since PDTA_NumAlloc may differ from PDTA_Allocated (where one is the reduced palette and the other is the number of pens allocated for display).		Contrary to previous versions of the picture.datatype, the PDTA_Allocated tag now returns the number of pens allocated during layout or remap. For the common use of the picture class, this value will be the same as that for PDTA_NumAlloc but where layout/remap has been performed without a screen, no pens can be allocated even though the (number of) colours in the destination bitmap may have been altered. Making a distinction between these two facets of the datatype allow remapping to be performed without intending to display the result; for example, simply reducing the colours or scaling a picture does not require a screen yet prior implementations require that it does. Anecdotally, I do not believe PDTA_AllocatedPens works as described in the "official" documentation since PDTA_ColorTable and PDTA_ColorTable2 are described as having potentially different pens; so when this occurs, the documented nature of a 1:1 mapping of PDTA_GRegs to PDTA_AllocatedPens is evidently false because there are two potential pens for one colour map entry with no way to distinguish those in the PDTA_AllocatedPens series. If the number of colours for a colour-mapped picture is limited to 256 (8-bit) then PDTA_NumAlloc can never be higher than this, leading to the values in PDTA_AllocatedPens only list half of the actual pens allocated. Plus, the values of PDTA_AllocatedPens do not match the palette entry when this occurs. Therefore, PDTA_NumColors is to PDTA_CRegs as PDTA_NumAlloc is to PDTA_GRegs. Thus, PDTA_Allocated shares this same relationship to PDTA_AllocatedPens since PDTA_NumAlloc may differ from PDTA_Allocated (where one is the reduced palette and the other is the number of pens allocated for display).

@@ Line 3: / Line 3: @@
 The '''picture.datatype''' is the root datatype class for pictures. It is the super-class for any picture related classes.
-=METHODS=
+=Methods=
 == Supported methods ==
@@ Line 85: / Line 85: @@
 |Quantize the source palette into a smaller set of colours using a specified algoritm for the purposes of remapping. Requires that PDTA_DestMode is PMODE_V43.
 |}
 =TAGS=

@@ Line 1: / Line 1: @@
-=picture.datatype=
+=Introduction=
-  NAME
-  picture.datatype -- the root datatype class for pictures.
+The '''picture.datatype''' is the root datatype class for pictures. It is the super-class for any picture related classes.
 =METHODS=