Difference between revisions of "Image Settings"
From GeeklogWiki
m (Reverted edit of BestWeb, changed back to last version by Tony) |
|||
| (3 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | Geeklog uses a flexible system for managing and manipulating images that are used in user profiles, articles and possibly in plugins. Geeklog administrators have the choice of using Imagemagick, NetPBM and GD. We've found that for ease of support NetPBM is the better package but which one you use will depend on what is installed on your system. For those in hosted environments you should ask your host which one (if any) of the image packages they have installed. | ||
| + | |||
| + | Configuring the image subsystem is easy, simply tell Geeklog which library you want to use and then configure how you want Geeklog to handle images. The following table gives a description of all the image related settings. | ||
| + | |||
| + | {| border=1 cellspacing=0 | ||
| + | !Variable | ||
| + | !Default Value | ||
| + | !Description | ||
| + | |- | ||
| + | |image_lib | ||
| + | |'' <i>(empty string)</i> | ||
| + | |Set this to either 'imagemagick', 'netpbm', or 'gdlib' if images should be resized during upload. Leave as '' if you don't want images to be resized or if you don't have those packages available. | ||
| + | |- | ||
| + | |path_to_mogrify | ||
| + | |''(commented out)'' | ||
| + | |If you chose 'imagemagick' for $_CONF['image_lib'] above, then this should hold the <strong>complete path</strong> to the mogrify binary (from the ImageMagick package), e.g. '/usr/bin/mogrify'.<br> | ||
| + | You will need a fairly recent version of [http://www.imagemagick.org/ ImageMagick] for this to work (version 5.4.9 or newer is recommended). | ||
| + | |- | ||
| + | |path_to_netpbm | ||
| + | |''(commented out)'' | ||
| + | |If you chose 'netpbm' for $_CONF['image_lib'] above, then this should hold the complete path to the <em>directory</em> where the binaries from the netpbm package are kept, e.g. '/usr/bin/netpbm/'. Note that the path must end in a slash.<br> | ||
| + | Precompiled binaries of the netpbm package for various platforms can be downloaded from the [http://sourceforge.net/projects/gallery/ Homepage of the Gallery] project. | ||
| + | |- | ||
| + | |keep_unscaled_image | ||
| + | |0 | ||
| + | |Set this to 1 if you want Geeklog to keep the original, unscaled images after upload. The smaller image will then be used as a thumbnail and will link to the original image. Note that this may use a lot of disk space (depending on the size of your images). | ||
| + | |- | ||
| + | |max_image_width | ||
| + | |300 | ||
| + | |Max. width of an image in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). | ||
| + | |- | ||
| + | |max_image_height | ||
| + | |300 | ||
| + | |Max. height of an image in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). | ||
| + | |- | ||
| + | |max_image_size | ||
| + | |1048576 ''(equals 1 MB)'' | ||
| + | |Max. size of an image in bytes. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). | ||
| + | |- | ||
| + | |max_photo_width | ||
| + | |96 | ||
| + | |Max. width of a user photo in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). | ||
| + | |- | ||
| + | |max_photo_height | ||
| + | |96 | ||
| + | |Max. height of a user photo in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). | ||
| + | |- | ||
| + | |max_photo_size | ||
| + | |65536 ''(equals 64 KB)'' | ||
| + | |Max. size of a user photo in bytes. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). | ||
| + | |} | ||
;[[The_Geeklog_Configuration_File|Back to The Geeklog Configuration File]] | ;[[The_Geeklog_Configuration_File|Back to The Geeklog Configuration File]] | ||
Latest revision as of 01:11, 10 December 2004
Geeklog uses a flexible system for managing and manipulating images that are used in user profiles, articles and possibly in plugins. Geeklog administrators have the choice of using Imagemagick, NetPBM and GD. We've found that for ease of support NetPBM is the better package but which one you use will depend on what is installed on your system. For those in hosted environments you should ask your host which one (if any) of the image packages they have installed.
Configuring the image subsystem is easy, simply tell Geeklog which library you want to use and then configure how you want Geeklog to handle images. The following table gives a description of all the image related settings.
| Variable | Default Value | Description |
|---|---|---|
| image_lib | (empty string) | Set this to either 'imagemagick', 'netpbm', or 'gdlib' if images should be resized during upload. Leave as if you don't want images to be resized or if you don't have those packages available. |
| path_to_mogrify | (commented out) | If you chose 'imagemagick' for $_CONF['image_lib'] above, then this should hold the complete path to the mogrify binary (from the ImageMagick package), e.g. '/usr/bin/mogrify'. You will need a fairly recent version of ImageMagick for this to work (version 5.4.9 or newer is recommended). |
| path_to_netpbm | (commented out) | If you chose 'netpbm' for $_CONF['image_lib'] above, then this should hold the complete path to the directory where the binaries from the netpbm package are kept, e.g. '/usr/bin/netpbm/'. Note that the path must end in a slash. Precompiled binaries of the netpbm package for various platforms can be downloaded from the Homepage of the Gallery project. |
| keep_unscaled_image | 0 | Set this to 1 if you want Geeklog to keep the original, unscaled images after upload. The smaller image will then be used as a thumbnail and will link to the original image. Note that this may use a lot of disk space (depending on the size of your images). |
| max_image_width | 300 | Max. width of an image in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). |
| max_image_height | 300 | Max. height of an image in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). |
| max_image_size | 1048576 (equals 1 MB) | Max. size of an image in bytes. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). |
| max_photo_width | 96 | Max. width of a user photo in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). |
| max_photo_height | 96 | Max. height of a user photo in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). |
| max_photo_size | 65536 (equals 64 KB) | Max. size of a user photo in bytes. If it exceeds this, it is either rejected or resized (depending on the setting of $_CONF['image_lib'] above). |
