• Publicity: Public Only All

image-procs.tcl

Procedures to handle image subtype Image magick handling procedures inspired and borrowed from photo-album and imagemagick packages

Location:
packages/acs-content-repository/tcl/image-procs.tcl
Created:
2006-07-31
Author:
Dave Bauer <dave@thedesignexperience.org>
CVS Identification:
$Id: image-procs.tcl,v 1.18.2.7 2024/02/25 10:40:35 gustafn Exp $

Procedures in this file

Detailed information

image::convert_binary (public)

 image::convert_binary

Find imagemagick convert binary

Author:
Dave Bauer <dave@solutiongrove.com>
Created:
2006-08-27

Partial Call Graph (max 5 caller/called nodes):
%3 test_acs_tcl_exec_optional_dependencies acs_tcl_exec_optional_dependencies (test acs-tcl) image::convert_binary image::convert_binary test_acs_tcl_exec_optional_dependencies->image::convert_binary test_acs_tcl_exec_required_dependencies acs_tcl_exec_required_dependencies (test acs-tcl) test_acs_tcl_exec_required_dependencies->image::convert_binary apm_package_id_from_key apm_package_id_from_key (public) image::convert_binary->apm_package_id_from_key parameter::get parameter::get (public) image::convert_binary->parameter::get util::which util::which (public) image::convert_binary->util::which _acs_tcl__acs_tcl_external_dependencies_helper _acs_tcl__acs_tcl_external_dependencies_helper (private) _acs_tcl__acs_tcl_external_dependencies_helper->image::convert_binary image::resize image::resize (public) image::resize->image::convert_binary

Testcases:
acs_tcl_exec_required_dependencies, acs_tcl_exec_optional_dependencies

image::filename_mime_type (public)

 image::filename_mime_type [ -filename filename ] \
    [ -mime_type mime_type ]

Use ns_guesstype if we don't know the mime_type

Switches:
-filename (optional)
Filename of image file
-mime_type (optional)
If known, the mime type of the file
Author:
Dave Bauer <dave@thedesignexperience.org>
Created:
2006-08-27

Partial Call Graph (max 5 caller/called nodes):
%3

Testcases:
No testcase defined.

image::get_file_dimensions (public)

 image::get_file_dimensions [ -filename filename ] \
    [ -mime_type mime_type ]

Get the width and height of an image from a file in the filesystem. This tries first to use built-in ns_*-support, and if not available, if talls back to imagemagick. We use imagemagick first since it supports many more image formats.

Switches:
-filename (optional)
full path to file in the filesystem
-mime_type (optional)
Returns:
Returns a list of width and height
Author:
Dave Bauer <dave@solutiongrove.com>
Created:
2006-08-28

Partial Call Graph (max 5 caller/called nodes):
%3 image::new image::new (public) image::get_file_dimensions image::get_file_dimensions image::new->image::get_file_dimensions image::imagemagick_file_dimensions image::imagemagick_file_dimensions (public) image::get_file_dimensions->image::imagemagick_file_dimensions image::ns_size image::ns_size (public) image::get_file_dimensions->image::ns_size

Testcases:
No testcase defined.

image::get_file_info (public)

 image::get_file_info [ -filename filename ]

Get info about an image file, dimensions, mime_type The name of this proc tries to make clear that we aren't getting info for an image type object, but examinging an image file in the filesystem

Switches:
-filename (optional)
Full path to file in the filesystem
Returns:
List of width, height, and mime_type

Partial Call Graph (max 5 caller/called nodes):
%3 image::get_file_info_array image::get_file_info_array (public) image::get_file_info image::get_file_info image::get_file_info_array->image::get_file_info image::imagemagick_identify image::imagemagick_identify (public) image::get_file_info->image::imagemagick_identify image::mime_type image::mime_type (public) image::get_file_info->image::mime_type image::ns_size image::ns_size (public) image::get_file_info->image::ns_size

Testcases:
No testcase defined.

image::get_file_info_array (public)

 image::get_file_info_array [ -filename filename ] \
    [ -array_name array_name ]

Get info about an image file, dimensions, mime_type into an array in the caller's namespace.

Switches:
-filename (optional)
Full path to file in the filesystem
-array_name (optional)
Array in caller's namespace to populate
Returns:
List of width height mime_type in array get format
Author:
Dave Bauer
Created:
2006-08-27
See Also:

Partial Call Graph (max 5 caller/called nodes):
%3 image::get_file_info image::get_file_info (public) image::get_file_info_array image::get_file_info_array image::get_file_info_array->image::get_file_info

Testcases:
No testcase defined.

image::get_info (public)

 image::get_info -filename filename -array array

Get the width and height of an image file. The width and height are returned as 'height' and 'width' entries in the array named in the parameter. Uses ImageMagick instead of AOLserver function because it can handle more than just gifs and jpegs. The plan is to add the ability to get more details later. This proc duplicates and seems somehow superseded by image::imagemagick_identify, it might be a good idea to deprecate it in the future. One important difference is this proc won't fail in case of error.

Switches:
-filename (required)
Name of the image file in the filesystem.
-array (required)
Name of an array where you want the information returned.
See Also:

Partial Call Graph (max 5 caller/called nodes):
%3 image::identify_binary image::identify_binary (public) image::get_info image::get_info image::get_info->image::identify_binary

Testcases:
No testcase defined.

image::get_resized_item_id (public)

 image::get_resized_item_id [ -item_id item_id ] \
    [ -size_name size_name ]

Get the item id of a related resized image, usually the thumbnail size

Switches:
-item_id (optional)
Item_id of the original image
-size_name (optional, defaults to "thumbnail")
Returns:
item_id of the resized image, empty string if it doeesn't exist
Author:
Dave Bauer <dave@solutiongrove.com>
Created:
2006-08-29

Partial Call Graph (max 5 caller/called nodes):
%3 db_string db_string (public) image::get_resized_item_id image::get_resized_item_id image::get_resized_item_id->db_string

Testcases:
No testcase defined.

image::identify_binary (public)

 image::identify_binary

Find imagemagick identify binary

Author:
Dave Bauer <dave@solutiongrove.com>
Created:
2006-08-27

Partial Call Graph (max 5 caller/called nodes):
%3 test_acs_tcl_exec_optional_dependencies acs_tcl_exec_optional_dependencies (test acs-tcl) image::identify_binary image::identify_binary test_acs_tcl_exec_optional_dependencies->image::identify_binary test_acs_tcl_exec_required_dependencies acs_tcl_exec_required_dependencies (test acs-tcl) test_acs_tcl_exec_required_dependencies->image::identify_binary apm_package_id_from_key apm_package_id_from_key (public) image::identify_binary->apm_package_id_from_key parameter::get parameter::get (public) image::identify_binary->parameter::get util::which util::which (public) image::identify_binary->util::which _acs_tcl__acs_tcl_external_dependencies_helper _acs_tcl__acs_tcl_external_dependencies_helper (private) _acs_tcl__acs_tcl_external_dependencies_helper->image::identify_binary image::get_info image::get_info (public) image::get_info->image::identify_binary image::imagemagick_file_dimensions image::imagemagick_file_dimensions (public) image::imagemagick_file_dimensions->image::identify_binary image::imagemagick_identify image::imagemagick_identify (public) image::imagemagick_identify->image::identify_binary

Testcases:
acs_tcl_exec_required_dependencies, acs_tcl_exec_optional_dependencies

image::imagemagick_file_dimensions (public)

 image::imagemagick_file_dimensions [ -filename filename ]

Get the dimensions of an image from imagemagick

Switches:
-filename (optional)
Full path to an image file in the filesystem
Author:
Dave Bauer <dave@solutiongrove.com>
Created:
2006-08-27

Partial Call Graph (max 5 caller/called nodes):
%3 image::get_file_dimensions image::get_file_dimensions (public) image::imagemagick_file_dimensions image::imagemagick_file_dimensions image::get_file_dimensions->image::imagemagick_file_dimensions image::identify_binary image::identify_binary (public) image::imagemagick_file_dimensions->image::identify_binary

Testcases:
No testcase defined.

image::imagemagick_identify (public)

 image::imagemagick_identify [ -filename filename ]

Get width height and mime type from imagemagick

Switches:
-filename (optional)
Full path to an image file in the filesystem
Returns:
List of width height mime_type
Author:
Dave Bauer <dave@solutiongrove.com>
Created:
2006-08-27

Partial Call Graph (max 5 caller/called nodes):
%3 image::get_file_info image::get_file_info (public) image::imagemagick_identify image::imagemagick_identify image::get_file_info->image::imagemagick_identify image::mime_type image::mime_type (public) image::mime_type->image::imagemagick_identify image::identify_binary image::identify_binary (public) image::imagemagick_identify->image::identify_binary

Testcases:
No testcase defined.

image::mime_type (public)

 image::mime_type [ -filename filename ]

Use ns-built-in mimetype or image magick if not available

Switches:
-filename (optional)
Filename of image file

Partial Call Graph (max 5 caller/called nodes):
%3 image::get_file_info image::get_file_info (public) image::mime_type image::mime_type image::get_file_info->image::mime_type image::imagemagick_identify image::imagemagick_identify (public) image::mime_type->image::imagemagick_identify

Testcases:
No testcase defined.

image::new (public)

 image::new [ -name name ] [ -parent_id parent_id ] \
    [ -item_id item_id ] [ -locale locale ] \
    [ -creation_date creation_date ] [ -creation_user creation_user ] \
    [ -context_id context_id ] [ -package_id package_id ] \
    [ -creation_ip creation_ip ] [ -item_subtype item_subtype ] \
    [ -content_type content_type ] [ -title title ] \
    [ -description description ] [ -mime_type mime_type ] \
    [ -relation_tag relation_tag ] [ -is_live is_live ] \
    [ -storage_type storage_type ] [ -attributes attributes ] \
    [ -tmp_filename tmp_filename ] [ -width width ] [ -height height ]

Create a new image object from a temporary file

Switches:
-name (optional)
Name of image item, must be unique per parent_id
-parent_id (optional)
Parent object for this image. Context_id will be set to parent_id
-item_id (optional)
Item id of the content item for this image. The item_id will be generated from the acs_object_id sequence if not specified.
-locale (optional)
-creation_date (optional)
-creation_user (optional)
-context_id (optional)
-package_id (optional)
-creation_ip (optional)
-item_subtype (optional, defaults to "content_item")
-content_type (optional, defaults to "image")
-title (optional)
-description (optional)
-mime_type (optional)
-relation_tag (optional)
-is_live (optional)
-storage_type (optional, defaults to "file")
-attributes (optional)
-tmp_filename (optional)
Filename in the filesystem, readable by AOLserver user to create image from
-width (optional)
-height (optional)
Returns:
Item_id
Error:
Author:
Dave Bauer <dave@thedesignexperience.org>
Created:
2006-07-31

Partial Call Graph (max 5 caller/called nodes):
%3 test_image_new image_new (test acs-content-repository) image::new image::new test_image_new->image::new content::item::new content::item::new (public) image::new->content::item::new image::get_file_dimensions image::get_file_dimensions (public) image::new->image::get_file_dimensions image::resize image::resize (public) image::resize->image::new packages/acs-templating/www/scripts/xinha/attach-file.tcl packages/acs-templating/ www/scripts/xinha/attach-file.tcl packages/acs-templating/www/scripts/xinha/attach-file.tcl->image::new packages/acs-templating/www/scripts/xinha/attach-image.tcl packages/acs-templating/ www/scripts/xinha/attach-image.tcl packages/acs-templating/www/scripts/xinha/attach-image.tcl->image::new packages/xowiki/www/xinha/attach-file.tcl packages/xowiki/ www/xinha/attach-file.tcl packages/xowiki/www/xinha/attach-file.tcl->image::new packages/xowiki/www/xinha/insert-file.tcl packages/xowiki/ www/xinha/insert-file.tcl packages/xowiki/www/xinha/insert-file.tcl->image::new

Testcases:
image_new

image::ns_size (public)

 image::ns_size [ -filename filename ] [ -mime_type mime_type ]

Use ns_gifsize/ns_jpegsize to try to get the size of an image

Switches:
-filename (optional)
Full path to file in the filesystem
-mime_type (optional)
Returns:
List containing width and height

Partial Call Graph (max 5 caller/called nodes):
%3 image::get_file_dimensions image::get_file_dimensions (public) image::ns_size image::ns_size image::get_file_dimensions->image::ns_size image::get_file_info image::get_file_info (public) image::get_file_info->image::ns_size

Testcases:
No testcase defined.

image::resize (public)

 image::resize [ -item_id item_id ] [ -revision_id revision_id ] \
    [ -size_name size_name ]

Create a thumbnail of an image in the content repository

Switches:
-item_id (optional)
item_id of image
-revision_id (optional)
-size_name (optional, defaults to "thumbnail")
Returns:
image item_id of the thumbnail
Author:
Dave Bauer <dave@solutiongrove.com>
Created:
2006-08-27

Partial Call Graph (max 5 caller/called nodes):
%3 image::resize_existing_images image::resize_existing_images (private) image::resize image::resize image::resize_existing_images->image::resize packages/acs-templating/www/scripts/xinha/attach-image.tcl packages/acs-templating/ www/scripts/xinha/attach-image.tcl packages/acs-templating/www/scripts/xinha/attach-image.tcl->image::resize ad_tmpdir ad_tmpdir (public) image::resize->ad_tmpdir ad_tmpnam ad_tmpnam (public) image::resize->ad_tmpnam content::item::get_best_revision content::item::get_best_revision (public) image::resize->content::item::get_best_revision content::revision::get_cr_file_path content::revision::get_cr_file_path (public) image::resize->content::revision::get_cr_file_path content::revision::new content::revision::new (public) image::resize->content::revision::new

Testcases:
No testcase defined.
[ show source ]