マニュアルキャンセル

cfimage

検索

最終更新日 : 2025年3月31日 | 次にも適用 : ColdFusion

CFML リファレンスユーザーガイド
ColdFusion 関数
ColdFusion のタグ
1. ColdFusion タグの概要
2. カテゴリ別の ColdFusion タグ
  1. アプリケーションフレームワークタグ
    1. cfapplication
    2. cfassociate
    3. cferror
    4. cfimport
    5. cfinterface
    6. cflock
    7. CFScript の
    8. cfthread
  2. 通信タグ
  3. データベース操作タグ
  4. データ出力タグ
    1. cfchart
    1. cfchartdata
    2. cfchartseries
    3. cfchartset
    4. cfcol
    5. cfcontent
    6. cfdocument
    7. cfdocumentitem
    8. cfdocumentsection
    9. cfflush
    10. cfheader
    11. cflog
    12. cfoutput
    13. cfpresentation
    14. cfpresentationslide
    15. cfpresenter
    16. cfprocessingdirective
    17. cfprint
    18. cfreport
    19. cfreportparam
    20. cfsilent
    21. cftable
  5. デバッグタグ
    1. cfdump
    2. cftimer
    3. cftrace
  6. 例外処理タグ
    1. cfcatch
    2. cferror
    3. cffinally
    4. cfrethrow
    5. cfthrow
    6. cftry
  7. 拡張タグ
    1. cfchart
    2. cfchartdata
    3. cfchartseries
    4. cfcollection
    5. cfcomponent
    6. cfexecute
    7. cfftp
    8. function
    9. cfindex
    10. cfinterface
    11. cfinvoke
    12. cfinvokeargument
    13. cfobject
    14. cfproperty
    15. cfreport
    16. cfreportparam
    17. cfreturn
    18. cfsearch
    19. cfsharepoint
    20. cfspreadsheet
    21. cfwddx
    22. cfxml
  8. ファイル管理タグ
  9. フロー制御タグ
    1. cfabort
    2. cfbreak
    3. cfcase
    4. cfcontinue
    5. cfdefaultcase
    6. cfelse
    7. cfelseif
    8. cfexecute
    9. cfexit
    10. cfif
    11. cfinclude
    12. cflocation
    13. cfloop
    14. cfrethrow
    15. cfswitch
    16. cfthrow
    17. cftry
  10. フォームタグ
    1. cfapplet
    2. cfcalendar
    3. cffileupload
    4. cfform
    5. cfformgroup
    6. cfformitem
    7. cfgrid
    8. cfgridcolumn
    9. cfgridrow
    10. cfgridupdate
    11. cfinput
    12. cfpdf
    13. cfpdfform
    14. cfpdfformparam
    15. cfpdfparam
    16. cfpdfsubform
    17. cfselect
    18. cfslider
    19. cftextarea
    20. cftree
    21. cftreeitem
  11. インターネットプロトコルタグ
    1. cfajaximport
    2. cfajaxproxy
    3. cfftp
    4. cffeed
    5. cfimap
    6. cfhttp
    7. cfhttpparam
    8. cfldap
    9. cfmail
    10. cfmailparam
    11. cfmailpart
    12. cfpop
    13. cfsprydataset
  12. ページ処理タグ
    1. cfcache
    2. cfcontent
    3. cfflush
    4. cfheader
    5. cfhtmlhead
    6. cfinclude
    7. cfprocessingdirective
    8. cfsetting
    9. cfsilent
  13. セキュリティタグ
  14. 変数操作タグ
    1. cfcookie
    2. cfdump
    3. cfparam
    4. cfregistry
    5. cfsavecontent
    6. cfschedule
    7. cfset
    8. cfsetting
  15. その他のタグ
    1. cfimage
    2. cflog
    3. cfregistry
3. タグ a～b
4. タグ c
5. タグ f
6. タグ g～h
  1. cfgraph
  2. cfgraphdata
  3. cfgrid
  4. cfgridcolumn
  5. cfgridrow
  6. cfgridupdate
  7. cfheader
  8. cfhtmlhead
  9. cfhtmltopdf
  10. cfhtmltopdfitem
  11. cfhttp
  12. cfhttpparam
7. タグ i
  1. cfif
  2. cfimage
  3. cfimap
  4. cfimapfilter
  5. cfimpersonate
  6. cfimport
  7. cfinclude
  8. cfindex
  9. cfinput
  10. cfinsert
  11. cfinterface
  12. cfinvoke
  13. cfinvokeargument
8. タグ j～l
9. タグ m～o
10. タグ p～q
  1. cfparam
  2. cfpdf
  3. cfpdfform
  4. cfpdfformparam
  5. cfpdfparam
  6. cfpdfsubform
  7. cfpod
  8. cfpop
  9. cfpresentation
  10. cfpresentationslide
  11. cfpresenter
  12. cfprint
  13. cfprocessingdirective
  14. cfprocparam
  15. cfprocresult
  16. cfprogressbar
  17. cfproperty
  18. cfquery
  19. cfqueryparam
11. タグ r～s
  1. cfregistry
  2. cfreport
  3. cfreportparam
  4. cfrethrow
  5. cfreturn
  6. cfsavecontent
  7. cfschedule
  8. cfscript
  9. cfsearch
  10. cfselect
  11. cfservlet
  12. cfservletparam
  13. cfset
  14. cfsetting
  15. cfsharepoint
  16. cfsilent
  17. cfslider
  18. cfspreadsheet
  19. cfsprydataset
  20. cfstoredproc
  21. cfswitch
12. タグ t
  1. cftable
  2. cftextarea
  3. cftextinput
  4. cfthread
  5. cfthrow
  6. cftimer
  7. cftooltip
  8. cftrace
  9. cftransaction
  10. cftree
  11. cftreeitem
  12. cftry
13. タグ u～z
  1. cfupdate
  2. cfwddx
  3. cfwebsocket
  4. cfwindow
  5. cfxml
  6. cfzip
  7. cfzipparam
CFML リファレンス
クラウドサービス

説明

ColdFusion イメージを作成します。cfimage タグを使用すると、Image 関数へのショートカットとして一般的なイメージ操作オペレーションを実行できます。 cfimage タグは、単独で使用することも、Image 関数と併用することもあります。

履歴

ColdFusion（2025リリース）：WebP 画像形式のサポートが追加されました。詳しくは、cfimage の WebP サポートを参照してください。

ColdFusion 10：{{cfimage action = "resize"}} に interpolation 属性が追加されました。

ColdFusion 8：このタグが追加されました。

カテゴリ

その他のタグ

シンタックス

Add a border to an image 
<cfimage 
required 
action = &quot;border&quot; 
source = &quot;absolute pathname|pathname relative to the web root|URL|#cfimage variable#&quot; 
optional 
color = &quot;hexadecimal value|web color&quot; 
destination = &quot;absolute pathname|pathname relative to the web root&quot; 
isBase64 = &quot;yes|no&quot; 
name = &quot;cfimage variable&quot; 
overwrite = &quot;yes|no&quot; 
thickness = &quot;number of pixels&quot;> 

Create a CAPTCHA image 
<cfimage 
required 
action = &quot;captcha&quot; 
height = &quot;number of pixels&quot; 
text = &quot;text string&quot; 
width = &quot;number of pixels&quot; 
optional 
destination = &quot;absolute pathname|pathname relative to the web root&quot; 
difficulty = &quot;high|medium|low&quot; 
overwrite = &quot;yes|no&quot; 
fonts = &quot;comma-separated list of font names&quot; 
fontSize = &quot;point size&quot;> 

Convert an image file format 
<cfimage 
required 
action = &quot;convert&quot; 
destination = &quot;absolute pathname|pathname relative to the web root&quot; 
source = &quot;absolute pathname|pathname relative to the web root&quot;|URL|#cfimage variable# 
optional 
isBase64 = &quot;yes|no&quot; 
name = &quot;cfimage variable&quot; 
overwrite = &quot;yes|no&quot;> 

Retrieve information about an image 
<cfimage 
required 
action = &quot;info&quot; 
source = &quot;absolute pathname|pathname relative to the web root|URL|#cfimage variable#&quot; 
structname = &quot;structure name&quot; 
optional 
isBase64 = &quot;yes|no&quot;> 

Read an image into memory 
<cfimage 
required 
name = &quot;cfimage variable&quot; 
source = &quot;absolute pathname|pathname relative to the web root|URL|#cfimage variable#&quot; 
optional 
action = &quot;read&quot; 
isBase64 = &quot;yes|no&quot;> 

Resize an image 
<cfimage 
required 
action = &quot;resize&quot; 
height = &quot;number of pixels|percent%&quot; 
source = &quot;absolute pathname|pathname relative to the web root|URL|#cfimage variable#&quot; 
width = &quot;number of pixels|percent%&quot; 
optional 
destination = &quot;absolute pathname|pathname relative to the web root&quot; 
isBase64 = &quot;yes|no&quot; 
name = &quot;cfimage variable&quot; 
overwrite = &quot;yes|no&quot;> 
interpolation = &quot;interpolation algorithm&quot; 

Rotate an image 
<cfimage 
required 
action = &quot;rotate&quot; 
angle = &quot;angle in degrees&quot; 
source = &quot;absolute pathname|pathname relative to the web root|URL|#cfimage variable#&quot; 
optional 
destination = &quot;absolute pathname|pathname relative to the web root&quot; 
isBase64= &quot;yes|no&quot; 
name = &quot;cfimage variable&quot; 
overwrite = &quot;yes|no&quot;> 

Write an image to a file 
<cfimage 
required 
action = &quot;write&quot; 
destination = &quot;absolute pathname|pathname relative to the web root&quot; 
source = &quot;absolute or relative pathname|URL|#cfimage variable#&quot; 
optional 
isBase64= &quot;yes|no&quot; 
overwrite = &quot;yes|no&quot; 
quality = &quot;JPEG image quality&quot;> 

Write an image to the browser 
<cfimage 
required 
action = &quot;writeToBrowser&quot; 
source = &quot;absolute pathname|pathname relative to the web root|URL|#cfimage variable#&quot; 
optional 
format = &quot;png|jpg|jpeg|webp&quot; 
isBase64= &quot;yes|no&quot;>

注意：

このタグの属性は attributeCollection 属性で指定でき、その値は構造体になります。 attributeCollection 属性で構造体の名前を指定し、タグの属性名を構造体のキーとして使用します。

属性

属性	アクション	必須／オプション	デフォルト	説明
action	該当なし	オプション	read	実行するアクションです。次のいずれかになります。 border captcha convert info read resize rotate write writeToBrowser デフォルトのアクションは read です。このアクションを明示的に指定する必要はありません。
angle	rotate	必須		画像を回転する角度（度単位）。値には整数を指定します。
color	border	オプション	black	ボーターのカラー。16 進数値またはサポートされているカラー色を指定します。「有効な HTML カラー名」にある名前のリストを参照してください。16 進数値で指定する場合は、"##xxxxxx" または "xxxxxx" という形式を使用します。ここで、x は 0 ～ 9 または A ～ F です。シャープ記号 (#) は 2 つ使用するか、または使用しないでください。
destination	border captcha convert resizerotate write	オプション（「説明」を参照）		イメージの出力先の絶対パス名または相対パス名です。イメージの形式は、ファイル拡張子によって決定されます。 convert および write アクションの場合、destination 属性は必須です。border、captcha、resize、および rotate アクションの場合は、name 属性または destination 属性が必須になります。両方を指定することもできます。ColdFusion では、PNG 形式の CAPTCHA イメージのみがサポートされています。 CAPTCHA イメージが配置される場所は、次のように決まります。 destination を指定した場合、イメージは、（指定した絶対パス名または相対パス名に基づいて）ファイルに書き込まれます。 name を指定した場合、イメージはイメージ変数に書き込まれます。 destination と name のどちらも指定しない場合、イメージはブラウザーに書き込まれます。
difficulty	captcha	オプション	low	CAPTCHA テキストの複雑度のレベルです。テキストの歪みのレベルを次のいずれかの値で指定します。 low medium high
fonts	captcha	オプション		CAPTCHA テキストで使用する有効なフォントです。複数のフォントを指定する場合は、カンマで区切ります。指定されたフォントを使用できない場合は、システムフォントが代用されます。
fontSize	captcha	オプション	24	CAPTCHA イメージ内のテキストのフォントサイズです。この値は整数で指定する必要があります。
format	writeToBrowser	オプション	PNG	ブラウザーに表示するイメージの形式です。形式を指定しない場合、イメージは PNG 形式で表示されます。ブラウザで GIF イメージを表示することはできません。 GIF イメージは PNG 形式で表示されます。
height	captcha resize	必須		イメージの高さです（単位 : ピクセル）。 resize の場合は、高さをパーセントで指定することもできます (整数値の後にパーセント (%) 記号を付けます)。イメージのサイズを変更する場合は、幅の値を指定して高さを "" に指定すると、ColdFusion で縦横比が計算されます。指定する場合、値は整数で指定する必要があります。
inter polation	resize	オプション	highest Quality	名前（hamming など）、イメージ品質（mediumQuality など）、またはパフォーマンス（highestPerformance など）を基準に特定の補間アルゴリズムを指定します。有効な値は次のとおりです。 highestQuality highQuality mediumQuality highestPerformance highPerformance mediumPerformance nearest bilinear bicubic bessel blackman hamming hanning hermite lanczos mitchell quadratic
isBase64	border convert info read resizerotate writewrite ToBrowser	オプション	yes	ソースが Base64 文字列であるかどうかを指定します。 yes：ソースは Base64 文字列です。 no：ソースは Base64 文字列ではありません。
name	border convertread resizerotate	オプション（「説明」を参照）		作成する ColdFusion イメージ変数の名前です。 read アクションの場合、name 属性は必須です。 border、resize、および rotate アクションの場合は、name 属性または destination 属性が必須になります。両方を指定することもできます。
overwrite	border captcha conver tread resizerotate write	オプション	yes	destination 属性が指定されている場合にのみ有効です。overwrite の値は次のとおりです。 yes：書き込み先のファイルを上書きします。 no：書き込み先のファイルを上書きしません。書き込み先のファイルが既に存在する場合は、overwrite アクションが yes に設定されていないとエラーが発生します。
quality	write	オプション	0.75	JPEG 形式の書き込み先ファイルの品質です。拡張子が JPG または JPEG のファイルに対してのみ適用されます。有効な値は、0 ～ 1 の間の小数です (値が小さいほど品質は低くなります)。
source	border convert info read resizerotate write write ToBrowser	必須		ソースイメージの URL（例："{{ http://www.google.com/images/logo.gif }}"）絶対パス名または Web ルートからの相対パス名（例："c:¥images¥logo.jpg"）別のイメージ、BLOB、またはバイト配列を含む ColdFusion イメージ変数（例："#myImage#"） Base64 文字列（例："data:image/jpg;base64,/9j/4AAQSkZJRgABAQA.............."）
struct Name	info	必須		作成する ColdFusion 構造体の名前です。
text	captcha	必須		CAPTCHA イメージ内に表示するテキスト文字列です。読みやすいように大文字を使用してください。 CAPTCHA イメージ内では見分けられないので、スペースは使用しないでください。
thickness	border	オプション	1	ボーダーの幅です（単位 : ピクセル）。ボーダーはソースイメージの外縁に追加されるため、ボーダーの幅に応じてイメージ領域が広くなります。この値は整数で指定する必要があります。
width	captcha resize	必須		イメージの幅です (単位 : ピクセル)。 resize の場合は、幅をパーセントで指定することもできます（整数値の後に % 記号を付けます）。イメージのサイズを変更する場合は、高さの値を指定して幅を "" に指定すると、ColdFusion で縦横比が計算されます。指定する場合、値は整数で指定する必要があります。

使用方法

ColdFusion には、cfimage タグに加え、ColdFusion イメージと呼ばれる概念があります。ColdFusion イメージとは、イメージデータを含む ColdFusion 固有の構造です。メモリ内で ColdFusion イメージを操作して、ファイル、データベース、ブラウザーなどに書き込むことができます。既存のイメージファイルから ColdFusion イメージを作成して、簡単なイメージアクション（回転やサイズ変更など）を実行するには、cfimage タグを使用します。また、ImageNew 関数を使用すると、何もない状態から ColdFusion イメージを作成することも、既存のイメージから ColdFusion イメージを作成することもできます。Image 関数を使用すると、cfimage タグまたは ImageNew 関数で作成した ColdFusion イメージに対して複雑なイメージ操作オペレーションを実行できます。
ColdFusion イメージに対しては、次のようなタスクを実行できます。

イメージのファイル形式を変換する。たとえば、BMP ファイルを JPEG ファイルに変換したり、Base64 文字列を GIF に変換することができます。
サーバーにアップロードするファイルのサイズを統一する。
JPEG イメージの品質を変更してサイズを制限する。
ColdFusion イメージをファイルに保存する。または、ブラウザに直接出力する。
cfquery タグ内で ImageGetBlob 関数を使用して、ColdFusion イメージを BLOB（Binary Large Object Bitmap）としてデータベースに挿入する。データベースから BLOB を抽出して ColdFusion イメージを生成することもできます。
透かしイメージを作成する。
サムネールイメージを作成する。
スパムを防止するために CAPTCHA（Completely Automated Public Turing test to tell Computers and Humans Apart）イメージを作成する。CAPTCHA イメージとは、機械では読み取れないように（ただし、人間には読み取れるように）歪められたテキストを含むイメージであり、本人確認などに使用されます。
詳細な例については、ColdFusion アプリケーションの開発の ColdFusion イメージの作成と操作を参照してください。

ファイル属性

次の構文を使用して、destination 属性および source 属性で指定されたディスクに書き込まれない、メモリ内のファイルを指定します。メモリ内のファイルを使用すると、一時的データの処理が速くなります。

ram:///filepath

ファイルパスには、ram:///petStore/images/poodle.jpg のようにディレクトリを含めることができます。ファイルを指定する前に、パスに含まれるディレクトリを作成しておく必要があります。メモリ内ファイルの使用方法について詳しくは、『ColdFusion アプリケーションの開発』の「ColdFusion アプリケーションの最適化」の「メモリ内ファイルの使用」を参照してください。

サポートされる画像ファイル形式

cfimage タグは、さまざまなファイル形式をサポートします。ColdFusion アプリケーションがデプロイされているサーバー上でサポートされている形式を一覧表示するには、GetReadableImageFormats 関数と GetWriteableImageFormats 関数を使用します。ColdFusion は、Macintosh、Windows、Unix オペレーティングシステムで次のデフォルトのイメージ形式をサポートしています。

JPEG
GIF
WEBP
TIFF
PNG
BMP

次のイメージ形式はサポートされていません。

アニメーション GIF
マルチページ TIFF
PSD
AI

CMYK サポート

cfimage タグでは、CMYK イメージの読み込みと書き込みがサポートされていますが、イメージの変換が必要なアクションはサポートされていません。たとえば、CMYK イメージは、read、write、writeToBrowser、resize、rotate、および info アクションで使用できます。一方、CMYK イメージは、convert、captcha、および border アクションでは使用できません。同じルールがイメージ関数にも適用されます。たとえば、ImageNew、ImageRead、および ImageWrite 関数では CMYK イメージがサポートされますが、ImageAddBorder 関数ではサポートされません。

有効な HTML カラー名

次の表に、color 属性で使用できる W3C HTML 4 カラー名または 16 進値を示します。

カラー名	RGB 値
Black	##000000
Blue	##0000FF
Red	##FF0000
Gray	##808080
LightGray	##D3D3D3
DarkGray	##A9A9A9
Green	##008000
Pink	##FFC0CB
Cyan	##00FFFF
Magenta	##FF00FF
Orange	##FFA500
White	##FFFFFF
Yellow	##FFFF00

その他の色を指定する場合は、16 進数値を入力します。 RGB 値を示す 6 桁の値を指定します。 00 ～ FF の範囲の値を使用できます。

イメージの品質

デフォルトでは、cfimage タグで生成されるイメージにはアンチエイリアス処理が適用されます（輪郭のジャギーが除去されます）。また、補間方式は highestQuality に設定されます。この方式では高品質のイメージが生成されますが、処理速度は低下します。アンチエイリアスをオフにするには、ImageSetAntialiasing 関数を使用します。補間方式の変更や、イメージ属性の制御には、次の関数を使用します。

イメージの外縁に矩形のボーダーを作成するには、border アクションを使用します。このアクションでは、ボーダーの幅と色を制御できます。その他の属性を制御するには、ImageAddBorder 関数を使用します。次の例では、ボーダーの幅と色を設定します。

<!--- 次の例では、既存の JPEG ファイルから ColdFusion イメージを作成し、そのイメージに 5 ピクセル幅の
赤い境界線を追加して、新しい JPEG ファイルに保存する方法を示しています。 --->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff05.jpg&quot; action=&quot;border&quot; thickness=&quot;5&quot;
destination=&quot;jeff05.jpg&quot; color=&quot;red&quot; overwrite=&quot;yes&quot;>

機械では読み取れないように（ただし、人間には読み取れるように）歪められたテキストイメージを作成するには、captcha アクションを使用します。CAPTCHA イメージを作成するには、CAPTCHA イメージで表示するテキストを指定します。このテキストが ColdFusion によってランダムに変形されます。このアクションでは、テキスト領域の高さと幅を指定できます。この設定は、文字の間隔、フォントサイズ、CAPTCHA テキストで使用するフォント、難読度に影響するため、テキストの読みやすさを左右します。次の例は、CAPTCHA イメージをブラウザに直接出力する方法を示しています。

<cfimage action=&quot;captcha&quot; fontSize=&quot;25&quot; width=&quot;400&quot; height=&quot;150&quot; text=&quot;rEadMe&quot;
fonts=&quot;Arial,Verdana,Courier New&quot;>

注意：

CAPTCHA イメージを表示するには、width を、"fontSize × text で指定した文字の数 × 1.08" より大きい値に設定する必要があります。この例の場合、width の最小値は 162 です。

ColdFusion では、PNG 形式の CAPTCHA イメージのみがサポートされています。

複数のユーザーが CAPTCHA イメージにアクセスした場合にファイルが上書きされないようにするには、CAPTCHA イメージファイルに一意の名前を付けます。

次の例は、difficulty を medium に設定して CAPTCHA イメージを作成し、ファイルに書き込む方法を示しています。

<!--- GetTickCount 関数を使用して、CAPTCHA ファイルの一意の名前を生成します。 --->
<cfset tc = GetTickCount()> 
<cfimage action=&quot;captcha&quot; fontSize=&quot;15&quot; width=&quot;180&quot; height=&quot;50&quot; text=&quot;rEadMe&quot;
destination=&quot;images/rEadMe#tc#.png&quot; difficulty=&quot;medium&quot;>

例について詳しくは、ColdFusion アプリケーションの開発の ColdFusion イメージの作成と操作を参照してください。

イメージのファイル形式を変換するには、convert アクションを使用します。ファイル形式の詳細については、「サポートされるイメージファイル形式」を参照してください。次の例は、JPEG ファイルを PNG ファイルに変換する方法を示しています。

<!--- 次の例は、JPEG イメージを PNG イメージに変換する方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/aiden02.jpg&quot; action=&quot;convert&quot;
destination=&quot;aiden02.png&quot;>

注意：

イメージのファイル形式を変換する作業には時間がかかります。また、イメージの品質が低下する場合もあります。たとえば、PNG イメージでは 24 ビットの色がサポートされていますが、GIF イメージでは 256 色しかサポートされていません。透明のイメージ (アルファ値を持つイメージ) を変換すると、品質が低下する場合があります。

info アクション イメージのカラーモデル、高さ、幅、ソースなど、イメージに関する情報を格納する ColdFusion 構造体を作成するには、info アクションを使用します。この構造体は、ImageInfo 関数が返す構造体と同じものです。次の例は、イメージに関するすべての情報を取得する方法を示しています。

<!--- 次の例では、イメージ情報を取得して表示する方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/viata03.jpg&quot; action=&quot;info&quot; structName=&quot;viatoInfo&quot;> 
<cfdump var=&quot;#viatoInfo#&quot;> 
 
<!--- または、次の例に示すように、cfoutput タグを使用して特定のイメージ情報を表示
することもできます。--->
<cfoutput> 
<p>height: #viatoInfo.height# pixels</p> 
<p>width: #viatoInfo.width# pixels</p> 
<p>source: #viatoInfo.source#</p> 
<p>transparency: #viatoInfo.colormodel.transparency#</p> 
<p>pixel size: #viatoInfo.colormodel.pixel_size#</p> 
<p>color model: #viatoInfo.colormodel.colormodel_type#</p> 
<p>alpha channel support: #viatoInfo.colormodel.alpha_channel_support#</p> 
<p>color space: #viatoInfo.colormodel.colorspace#</p> 
</cfoutput>

read アクション 指定したローカルのファイルパス名または URL からイメージを読み込んで、メモリ内に ColdFusion イメージを作成するには、read アクションを使用します。 ColdFusion イメージ変数は、別の cfimage タグや Image 関数のソースとして使用できます。read アクションは、ImageRead 関数と同じオペレーションを実行します。次の例では、JPEG ファイルから ColdFusion イメージを作成し、ImageGrayscale 関数を使用してイメージを操作する方法を示しています。

<!--- 次のコードは、JPEG ファイルから ColdFusion イメージを作成する方法を示しています。
--->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff01.jpg&quot; name=&quot;myImage&quot;> 
<!--- 次のコードは、イメージをグレースケールに変換する方法を示しています。--->
<cfset ImageGrayscale(myImage)> 
<!--- 次のコードは、グレースケール画像を JPEG ファイルに書き込む方法を示しています。--->
<cfimage source=&quot;#myImage#&quot; action=&quot;write&quot; destination=&quot;myGrayscaleImage.jpg&quot; overwrite=&quot;yes&quot;>

resize アクション イメージの高さと幅を変更するには、resize アクションを使用します。高さと幅を設定するには、ピクセル数またはパーセント値を指定します。

<!--- この例では、イメージの高さと幅をピクセル単位で指定する方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff01.jpg&quot; action=&quot;resize&quot; width=&quot;100&quot; height=&quot;100&quot; destination=&quot;jeff01_thumbnail.jpg&quot; overwrite=&quot;yes&quot;> 
<!--- 次の例では、イメージの高さと幅をパーセンテージで指定する方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff02.jpg&quot; action=&quot;resize&quot;
width=&quot;50%&quot; height=&quot;50%&quot; destination=&quot;jeff02_thumbnail.jpg&quot; overwrite=&quot;yes&quot;> 
<!--- 次の例では、イメージの高さをピクセル単位で指定し、幅をパーセンテージで指定する
方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff03.jpg&quot; action=&quot;resize&quot;
width=&quot;50%&quot; height=&quot;100&quot; destination=&quot;jeff03_thumbnail.jpg&quot; overwrite=&quot;yes&quot;>

サイズ変更に関するその他の属性を制御するには、ImageResize 関数を使用します。

rotate アクション イメージを指定した角度だけ回転させるには、rotate アクションを使用します。

<!--- 次の例では、画像を 30 度回転する方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/maxwell01.jpg&quot; action=&quot;rotate&quot; angle=&quot;30&quot;
name=&quot;maxwellAngle&quot;> 
<!--- 回転した画像をブラウザーで表示します。 --->
<cfimage source=&quot;#maxwellAngle#&quot; action=&quot;writeToBrowser&quot;>

回転に関するその他の属性を制御するには、ImageRotate 関数を使用します。

write アクション 指定したパスにイメージを書き込むには、write アクションを使用します。新しいイメージは、destination 属性で指定したファイルタイプに変換されます。write アクションは、ImageWrite 関数と同じオペレーションを実行します。イメージを JPEG ファイルに書き込む場合のデフォルトのイメージ品質は、元のイメージの 75% に設定されます。イメージのサイズを制御するには、write アクションの quality 属性を使用します。
write アクションを使用して JPEG イメージの品質を変更すると、ファイルサイズを小さくすることができます。次の例は、イメージの品質を 0.5 に変更する方法を示しています。

<!--- 次の例では、write アクションを使用して JPEG ファイルから PNG ファイルを作成する方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/aiden01.jpg&quot; action=&quot;write&quot;
destination=&quot;aiden01.png&quot;> 
<!--- 次の例では、低画質の JPEG 画像を作成する方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff05.jpg&quot; action=&quot;write&quot;
destination=&quot;jeff05_lq.jpg&quot; quality=&quot;.5&quot;> 
<!--- 次の例では、JPEG ファイルを新しい場所に書き込む方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff05.jpg&quot; action=&quot;write&quot;
destination=&quot;jeff05.jpg&quot;>

writeToBrowser アクション ColdFusion イメージをファイルに書き込まずに直接ブラウザーに表示するには、writeToBrowser アクションを使用します。イメージは PNG 形式で表示されます。次の例は、イメージのサイズを小さくしてからブラウザにイメージを表示する方法を示しています。

<!--- 次の例では、JPEG ファイルから ColdFusion イメージを作成し、サイズを変更して、ブラウザーに PNG イメージとして表示する方法を示しています。--->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff05.jpg&quot; action=&quot;resize&quot;
width=&quot;50%&quot; height=&quot;50%&quot; name=&quot;smLogo&quot;> 
<cfimage source=&quot;#smLogo#&quot; action=&quot;writeToBrowser&quot;>

例

次の例は、ColdFusion イメージを作成し、Image 関数を使用してイメージを操作する方法を示しています。

<!--- JPEG ファイルから ColdFusion イメージ変数「myImage」を作成します。--->
<cfimage source=&quot;../cfdocs/images/artgallery/jeff05.jpg&quot; name=&quot;myImage&quot;> 
<!--- ColdFusion イメージをイメージ関数に渡して、イメージを半径 5 でぼかし、イメージ
を 90 度反転し、イメージをグレースケールに変換します。--->
<cfset ImageBlur(myImage,5)> 
<cfset ImageFlip(myImage,&quot;90&quot;)> 
<cfset ImageGrayscale(myImage)> 
<!--- 変換したイメージをブラウザーに書き込みます。--->
<cfimage source=&quot;#myImage#&quot; action=&quot;writeToBrowser&quot;>

WebP 画像のサポート

WebP は、web 上の画像をより高い圧縮率で圧縮できる画像形式です。非可逆圧縮と可逆圧縮の両方をサポートします。

WebP の主な機能

非可逆圧縮と可逆圧縮：WebP は、非可逆圧縮または可逆圧縮のいずれかの方法で画像を圧縮できるので、JPEG や PNG などの従来の形式に比べてファイルサイズが小さくなります。
透明度：WebP は、PNG と同様の透明な画像をサポートしています。これは、背景が透明な画像やオーバーレイグラフィックに役立ちます。
アニメーション：WebP は、アニメーション画像も処理できるので、GIF よりも圧縮率と画質に優れた代替手段となります。
幅広いサポート：Google Chrome、Firefox、Edge、Opera などの最新の web ブラウザーは WebP をサポートしているので、web 開発者にとって実用的な選択肢となります。
効率的な圧縮：WebP では通常、JPEG、PNG、GIF 形式と比較してファイルサイズが小さくなり、同等以上の画質が維持されます。この効率性により、web サイトの読み込み時間が短縮され、帯域幅の使用量も削減される場合があります。

cfimage の read および write アクションを使用すると、WebP ファイルを読み取り、画像処理を適用し、変更されたファイルをディスクに書き戻すことができます。

例

<cfset imagePath = &quot;fire.webp&quot;> 
<cftry>
    <cfimage action=&quot;read&quot; source=&quot;#imagePath#&quot; name=&quot;myImage&quot;>
    <cfoutput>
        Image read successfully.
    </cfoutput>
    <cfcatch type=&quot;image&quot;>
    <cfoutput>
        #cfcatch.message#
    </cfoutput>
    </cfcatch>
</cftry>
<!--- 画像にブラーを適用します --->
<cfset ImageBlur(myImage,10)>
<cftry>
    <cfimage action=&quot;write&quot; source=&quot;#myImage#&quot; destination=&quot;blurred_fire.webp&quot; overwrite=&quot;true&quot;>
    <cfoutput>
        Image blurred successfully.
    </cfoutput>
    <cfcatch type=&quot;image&quot;>
    <cfoutput>
        #cfcatch.message#
    </cfoutput>
    </cfcatch>
</cftry>

ヘルプをすばやく簡単に入手

新規ユーザーの場合