Difference between revisions of "Image Settings"

From GeeklogWiki
Jump to: navigation, search
 
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).
Back to The Geeklog Configuration File