PreviewPack - Revision history

MarkJFox: 15 revisions imported

2025-03-31T20:01:00Z

15 revisions imported

← Older revision	Revision as of 22:01, 31 March 2025
(No difference)

en>Vananabanana: Better example code reference (added line goto)

2022-06-19T15:28:26Z

Better example code reference (added line goto)

← Older revision		Revision as of 17:28, 19 June 2022
Line 47:		Line 47:
	== See also ==		== See also ==
	{{fn\|1\|[[https://docs.google.com/spreadsheet/ccc?key=0AiVQdoAJ4w7bdGFraGRqM3FZZk5FWVBiR0pIYnJGbGc&usp=sharing C&C TS/RA2 - PreviewPack / LocalSize / Map Size proportions]] - Spreadsheet containing the proportions between preview size LocalSize and full map size for the official TS, FS, RA2 and YR maps.}}		{{fn\|1\|[[https://docs.google.com/spreadsheet/ccc?key=0AiVQdoAJ4w7bdGFraGRqM3FZZk5FWVBiR0pIYnJGbGc&usp=sharing C&C TS/RA2 - PreviewPack / LocalSize / Map Size proportions]] - Spreadsheet containing the proportions between preview size LocalSize and full map size for the official TS, FS, RA2 and YR maps.}}
	{{fn\|2\|[[https://github.com/CnCNet/xna-cncnet-client/blob/450cfb1c0a03e8af7fb1d2388d55d1f9bd285fd8/DXMainClient/Domain/Multiplayer/MapPreviewExtractor.cs MapPreviewExtractor.cs]] - Decoder example code from the CNCNet Client.}}		{{fn\|2\|[[https://github.com/CnCNet/xna-cncnet-client/blob/450cfb1c0a03e8af7fb1d2388d55d1f9bd285fd8/DXMainClient/Domain/Multiplayer/MapPreviewExtractor.cs#L73 MapPreviewExtractor.cs]] - Decoder example code from the CNCNet Client.}}

en>Vananabanana: Corrected and clarified information on decoding the preview

2022-06-19T15:26:44Z

Corrected and clarified information on decoding the preview

← Older revision		Revision as of 17:26, 19 June 2022
Line 1:		Line 1:
	{{WrongTitle\|[PreviewPack]}}		{{WrongTitle\|[PreviewPack]}}
			This section in a map file contains the picture that is to be used as the map preview. The dimensions of this image are given in the [[Preview]] section.
	~~[[File:DCUprisingPreviewOfficial.png\|200px\|thumb\|right\|Original preview of the DC Uprising map]]~~		The image itself is stored as a single huge base64-encoded string spanning across every key in the PreviewPack section.{{fnl\|2}}
	This section in a map file contains the picture that is to be used as the map preview. The dimensions of this image are given in the [[Preview]] section. The image itself is stored as a base64-encoded string of ~~LZO~~ compressed data ~~that, when decompressed, contains~~ the ~~image~~ in ~~BGR~~ format. The scanline of each row of pixels is precisely 3 times the width, i.e. no additional padding is used.		When decoded, the string will contain blocks of compressed pixel data:
			- 2 unsigned bytes of the compressed block size (excluding this header)
			- 2 unsigned bytes of the uncompressed block size (excluding this header)
			- [http://www.oberhumer.com/opensource/lzo/ LZO compressed] pixels in BGR888 format.
			The scanline of each row of pixels is precisely 3 times the width, i.e. no additional padding is used.

	== Editing previews ==		== Editing previews ==
Line 44:		Line 46:

	== See also ==		== See also ==
	{{fn\|1\|[[https://docs.google.com/spreadsheet/ccc?key=0AiVQdoAJ4w7bdGFraGRqM3FZZk5FWVBiR0pIYnJGbGc&usp=sharing C&C TS/RA2 - PreviewPack / LocalSize / Map Size proportions]] - Spreadsheet containing the proportions between preview ~~sizem~~ LocalSize and full map size for the official TS, FS, RA2 and YR maps.}}		{{fn\|1\|[[https://docs.google.com/spreadsheet/ccc?key=0AiVQdoAJ4w7bdGFraGRqM3FZZk5FWVBiR0pIYnJGbGc&usp=sharing C&C TS/RA2 - PreviewPack / LocalSize / Map Size proportions]] - Spreadsheet containing the proportions between preview size LocalSize and full map size for the official TS, FS, RA2 and YR maps.}}
			{{fn\|2\|[[https://github.com/CnCNet/xna-cncnet-client/blob/450cfb1c0a03e8af7fb1d2388d55d1f9bd285fd8/DXMainClient/Domain/Multiplayer/MapPreviewExtractor.cs MapPreviewExtractor.cs]] - Decoder example code from the CNCNet Client.}}

en>Zzattack at 10:57, 27 August 2013

2013-08-27T10:57:01Z

← Older revision		Revision as of 12:57, 27 August 2013
Line 16:		Line 16:
	== Width/height proportions of original maps ==		== Width/height proportions of original maps ==
	[[File:PreviewPackWrongDimensionsRatio.png\|200px\|thumb\|right\|PreviewPack that does not adhere to official dimensions ratio]]		[[File:PreviewPackWrongDimensionsRatio.png\|200px\|thumb\|right\|PreviewPack that does not adhere to official dimensions ratio]]
	The dimensions of the preview image on official maps appear to have a relation to either the LocalSize or Size of the map, depending on the game. Deviating from these dimensions ''can'' but not always will cause unwanted black pixels to appear in the image, as can be seen in the image on the right. The table below shows the formulas that appear to be used, values presented are rounded and not precise. They were taken from the research presented at{{fnl\|1}}, where more precise values can be found.		The dimensions of the preview image on official maps appear to have a relation to either the LocalSize or Size of the map, depending on the game. Deviating from these dimensions ''can'' but not always will cause unwanted black pixels to appear in the image, as can be seen in the image on the right. This was confirmed at least for Yuri's Revenge. The table below shows the formulas that appear to be used, values presented are rounded and not precise. They were taken from the research presented at{{fnl\|1}}, where more precise values can be found.

	{\| align="center" cellpadding="4" class="table_descrowdesccol"		{\| align="center" cellpadding="4" class="table_descrowdesccol"

en>Zzattack at 16:49, 26 August 2013

2013-08-26T16:49:19Z

@@ Line 1: / Line 1: @@
 {{WrongTitle|[PreviewPack]}}
-This section in a map file contains the picture that is to be used as the map preview. The dimensions of this image are given in the [[Preview]] section. The image itself is stored as a base64-encoded string of LZO compressed data that, when decompressed, contains the image in BGR format. The scanline of each row of pixels is precisely 3 times the width, i.e. no additional padding is used. For official maps, the dimensions of the preview image are 1.975 times the width of the [[LocalSize]] and 1.0 times the size of the height of this LocalSize.
+[[File:DCUprisingPreviewOfficial.png|200px|thumb|right|Original preview of the DC Uprising map]]
 There is little need to edit this manually, as [[XCC Mixer]] can [[XCC Mixer file conversion#Copy As|create this section]] from any desired picture, which can then be pasted into a map file. This is used in the newest version of the [[Assault Mappacks]] to display an informational picture to users which are playing an Assault-compatible mod without downloading the mappacks themselves. (See the Assault Mappacks page for more info.)
-The map editor [[Final Alert]] is also capable of generating previews based on the tiles of the map. Higher quality previews can be obtained using a resized picture of the full map. The [http://github.com/zzattack/ccmaps-net CNCMaps rendering tool] contains an option to directly inject a high-quality preview into the map.
+The map editor [[Final Alert]] is also capable of generating previews based on the tiles of the map. Higher quality previews can be obtained using a resized picture of the full map. The [http://github.com/zzattack/ccmaps-net CNCMaps rendering tool] contains an option to create these, and directly inject a high-quality preview into the map.
 [[Category:Maps Sections|PreviewPack]]
 == See also ==
-==See also==
+{{fn|1|[[https://docs.google.com/spreadsheet/ccc?key=0AiVQdoAJ4w7bdGFraGRqM3FZZk5FWVBiR0pIYnJGbGc&usp=sharing C&C TS/RA2 - PreviewPack / LocalSize / Map Size proportions]] - Spreadsheet containing the proportions between preview sizem LocalSize and full map size for the official TS, FS, RA2 and YR maps.}}

en>Zzattack at 14:19, 26 August 2013

2013-08-26T14:19:54Z

← Older revision		Revision as of 16:19, 26 August 2013
Line 7:		Line 7:

	[[Category:Maps Sections\|PreviewPack]]		[[Category:Maps Sections\|PreviewPack]]


			==See also==
			*[[https://docs.google.com/spreadsheet/ccc?key=0AiVQdoAJ4w7bdGFraGRqM3FZZk5FWVBiR0pIYnJGbGc&usp=sharing Offical maps ratio speadsheet]] - Spreadsheet of ratio between preview size and LocalSize for offial YR and TS maps.

en>Zzattack at 14:02, 26 August 2013

2013-08-26T14:02:08Z

← Older revision		Revision as of 16:02, 26 August 2013
Line 1:		Line 1:
	{{WrongTitle\|[PreviewPack]}}		{{WrongTitle\|[PreviewPack]}}

	This section in a map file contains a base64-encoded string of LZO compressed data that, when decompressed, ~~represents~~ the ~~picture that~~ is ~~to be~~ used as the ~~map~~ preview~~, in BGR format~~. ~~Red~~ and ~~blue values therefor have to be swapped~~.		This section in a map file contains the picture that is to be used as the map preview. The dimensions of this image are given in the [[Preview]] section. The image itself is stored as a base64-encoded string of LZO compressed data that, when decompressed, contains the image in BGR format. The scanline of each row of pixels is precisely 3 times the width, i.e. no additional padding is used. For official maps, the dimensions of the preview image are 1.975 times the width of the [[LocalSize]] and 1.0 times the size of the height of this LocalSize.
	There is little need to edit this manually, as [[~~XCC:Mixer\|~~XCC Mixer]] can [[XCC Mixer file conversion#Copy As\|create this section]] from any desired picture, which can then be pasted into a map file. This is used in the newest version of the [[Assault Mappacks]] to display an informational picture to users which are playing an Assault-compatible mod without downloading the mappacks themselves. (See the Assault Mappacks page for more info.)
			There is little need to edit this manually, as [[XCC Mixer]] can [[XCC Mixer file conversion#Copy As\|create this section]] from any desired picture, which can then be pasted into a map file. This is used in the newest version of the [[Assault Mappacks]] to display an informational picture to users which are playing an Assault-compatible mod without downloading the mappacks themselves. (See the Assault Mappacks page for more info.)
			The map editor [[Final Alert]] is also capable of generating previews based on the tiles of the map. Higher quality previews can be obtained using a resized picture of the full map. The [http://github.com/zzattack/ccmaps-net CNCMaps rendering tool] contains an option to directly inject a high-quality preview into the map.

	[[Category:Maps Sections\|PreviewPack]]		[[Category:Maps Sections\|PreviewPack]]

en>DCoder: Maps/PreviewPack moved to PreviewPack: Moving the Maps/ sections' pages to main space.

2008-06-17T18:59:42Z

Maps/PreviewPack moved to PreviewPack: Moving the Maps/ sections' pages to main space.

← Older revision	Revision as of 20:59, 17 June 2008
(No difference)

84.27.10.51 at 11:33, 21 April 2007

2007-04-21T11:33:08Z

← Older revision		Revision as of 13:33, 21 April 2007
Line 1:		Line 1:
	{{WrongTitle\|[PreviewPack]}}		{{WrongTitle\|[PreviewPack]}}

	This section in a map file contains a base64-encoded string of LZO compressed data that, when decompressed, represents the picture that is to be used as the map preview.		This section in a map file contains a base64-encoded string of LZO compressed data that, when decompressed, represents the picture that is to be used as the map preview, in BGR format. Red and blue values therefor have to be swapped.
	There is little need to edit this manually, as [[XCC:Mixer\|XCC Mixer]] can [[XCC Mixer file conversion#Copy As\|create this section]] from any desired picture, which can then be pasted into a map file. This is used in the newest version of the [[Assault Mappacks]] to display an informational picture to users which are playing an Assault-compatible mod without downloading the mappacks themselves. (See the Assault Mappacks page for more info.)		There is little need to edit this manually, as [[XCC:Mixer\|XCC Mixer]] can [[XCC Mixer file conversion#Copy As\|create this section]] from any desired picture, which can then be pasted into a map file. This is used in the newest version of the [[Assault Mappacks]] to display an informational picture to users which are playing an Assault-compatible mod without downloading the mappacks themselves. (See the Assault Mappacks page for more info.)

	[[Category:Maps Sections\|PreviewPack]]		[[Category:Maps Sections\|PreviewPack]]

84.27.10.51 at 11:24, 21 April 2007

2007-04-21T11:24:24Z

← Older revision		Revision as of 13:24, 21 April 2007
Line 1:		Line 1:
	{{WrongTitle\|[PreviewPack]}}		{{WrongTitle\|[PreviewPack]}}

	This section in a map file contains a base64-encoded ~~version~~ of the picture that is to be used as the map preview. ~~It is stored in a 0-based array, each line containing up to 70 characters.~~ There is little need to edit this manually, as [[XCC:Mixer\|XCC Mixer]] can [[XCC Mixer file conversion#Copy As\|create this section]] from any desired picture, which can then be pasted into a map file. This is used in the newest version of the [[Assault Mappacks]] to display an informational picture to users which are playing an Assault-compatible mod without downloading the mappacks themselves. (See the Assault Mappacks page for more info.)		This section in a map file contains a base64-encoded string of LZO compressed data that, when decompressed, represents the picture that is to be used as the map preview.
			There is little need to edit this manually, as [[XCC:Mixer\|XCC Mixer]] can [[XCC Mixer file conversion#Copy As\|create this section]] from any desired picture, which can then be pasted into a map file. This is used in the newest version of the [[Assault Mappacks]] to display an informational picture to users which are playing an Assault-compatible mod without downloading the mappacks themselves. (See the Assault Mappacks page for more info.)

	[[Category:Maps Sections\|PreviewPack]]		[[Category:Maps Sections\|PreviewPack]]