Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

grfcodec(1) [debian man page]

GRFCodec(1)						    BSD General Commands Manual 					       GRFCodec(1)

NAME

     GRFCodec -- A tool to convert a GRF file into graphics files and meta data, and vice versa.

SYNOPSIS

     grfcodec [-sv] [-d | -e] [options] GRF-file [Directory]

	      <GRF-File> denotes the .GRF file you want to work on, e.g. TRG1.GRF

	      <Directory> is where the individual sprites should be saved. If omitted, they will default to a subdirectory called sprites/.

OPTIONS

     -? 	 Display the help message.

     -e 	 Encode a GRF file. The GRF-file to pass is the file where to encode to. The source of the GRF-file, i.e. the .nfo, will be looked
		 for in sprites/GRF-file.nfo.  All graphics files will be searched for relative from the location of the GRF-file.

     -d 	 Decode a GRF file. The GRF-file to pass is the file to decode. The result will be in sprites/GRF-file.nfo and
		 sprites/GRF-file.png.

     -s 	 Silences the progress output in interactive mode

     -v 	 Display the version.

     Options for decoding:

     -w num	 Write spritesheets files with the given width (default 800, minimum 16)

     -h num	 Split spritesheets when they reach this height (default no limit, minimum 16)

     -b num	 Organize sprites in boxes of this size (default 16)

     -o ssf	 Sets the format of generated spritesheets.  See -o ? for a list.

     -p pal	 Use this palette instead of the default.  See -p ? for a list.

     -t 	 Disable decoding of plain text characters as strings.

     -x 	 Disable production of unquoted escape sequences.

     -xx	 Disable production of both quoted and unquoted escape sequences.

		 This has the side effect of producing a version 6 .nfo, instead of a version 7 .nfo.

     -X 	 List sprite numbers in the image file in hex.

     Options for encoding:

     -c 	 Crop extraneous transparent blue from real sprites

     -u 	 Save uncompressed data (probably not a good idea)

     -q 	 Suppress warning messages

     -g num	 Create a GRF file with the given container version. Valid versions are 1 and 2, where the latter allows bigger sprites, larger
		 sounds, and multiple zoom levels and bit depths for the sprites.

     -n 	 Try both compression algorithms and use the most efficient. This might cause trouble when loading the NewGRF in TTDPatch.

     Options for both encoding and decoding:

     -m num	 Apply colour translation to all sprites except character-glyphs.

     -M num	 Apply colour translation to all sprites.

		 If both of these are specified, only the last is obeyed.  -m ? or -M ? for a list of colour translations.

SEE ALSO

     The documentation in /usr/share/doc/grfcodec/

AUTHOR

     GRFCodec was written by Josef Drexler.

     This manual page was written by Remko Bijker.

COPYRIGHT

     GRFCodec is Copyright (C) 2000-2005 by Josef Drexler <josef@ttdpatch.net>

								 February 24, 2012

Check Out this Related Man Page

draw_sprite(3alleg4)						  Allegro manual					      draw_sprite(3alleg4)

NAME

       draw_sprite - Draws a copy of the sprite onto the destination bitmap. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       void draw_sprite(BITMAP *bmp, BITMAP *sprite, int x, int y);

DESCRIPTION

       Draws a copy of the sprite bitmap onto the destination bitmap at the specified position. This is almost the same as blit(sprite, bmp, 0, 0,
       x, y, sprite->w, sprite->h), but it uses a masked drawing mode where transparent pixels are skipped, so	the  background  image	will  show
       through the masked parts of the sprite. Transparent pixels are marked by a zero in 256-color modes or bright pink for truecolor data (maxi-
       mum red and blue, zero green). Example:

	  BITMAP *spaceship;
	  ...
	  draw_sprite(screen, spaceship, x, y);

       If the GFX_HW_VRAM_BLIT_MASKED bit in the gfx_capabilities flag is set, the current driver supports  hardware  accelerated  sprite  drawing
       when  the  source  image is a video memory bitmap or a sub-bitmap of the screen. This is extremely fast, so when this flag is set it may be
       worth storing some of your more frequently used sprites in an offscreen portion of the video memory.

       Warning: if the hardware acceleration flag is not set, draw_sprite() will not work correctly when used with a sprite  image  in	system	or
       video memory so the latter must be a memory bitmap.

       Although  generally  not  supporting  graphics  of mixed color depths, as a special case this function can be used to draw 256-color source
       images onto truecolor destination bitmaps, so you can use palette effects on specific sprites within a truecolor program.

SEE ALSO

       draw_sprite_v_flip(3alleg4), draw_trans_sprite(3alleg4), draw_lit_sprite(3alleg4),  draw_gouraud_sprite(3alleg4),  stretch_sprite(3alleg4),
       rotate_sprite(3alleg4),	  draw_character_ex(3alleg4),	draw_rle_sprite(3alleg4),   draw_compiled_sprite(3alleg4),   masked_blit(3alleg4),
       blit(3alleg4), bitmap_mask_color(3alleg4), exsprite(3alleg4)

Allegro 							   version 4.4.2					      draw_sprite(3alleg4)
Man Page