1 2 3 4 5 <!DOCTYPE html> 6 <html lang="en"> 7 <head> 8 <meta charset="utf-8" /> 9 <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1,shrink-to-fit=no" /> 10 <title>MagickCore, C API: Set Text Attributes @ ImageMagick</title> 11 <meta name="application-name" content="ImageMagick" /> 12 <meta name="description" content="Use ImageMagick to create, edit, compose, or convert bitmap images. You can resize your image, crop it, change its shades and colors, add captions, among other operations." /> 13 <meta name="application-url" content="https://imagemagick.org" /> 14 <meta name="generator" content="PHP" /> 15 <meta name="keywords" content="magickcore, c, api:, set, text, attributes, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert" /> 16 <meta name="rating" content="GENERAL" /> 17 <meta name="robots" content="INDEX, FOLLOW" /> 18 <meta name="generator" content="ImageMagick Studio LLC" /> 19 <meta name="author" content="ImageMagick Studio LLC" /> 20 <meta name="revisit-after" content="2 DAYS" /> 21 <meta name="resource-type" content="document" /> 22 <meta name="copyright" content="Copyright (c) 1999-2019 ImageMagick Studio LLC" /> 23 <meta name="distribution" content="Global" /> 24 <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" /> 25 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" /> 26 <link href="attribute.html" rel="canonical" /> 27 <link href="../../images/wand.png" rel="icon" /> 28 <link href="../../images/wand.ico" rel="shortcut icon" /> 29 <link href="../assets/magick.css" rel="stylesheet" /> 30 </head> 31 <body> 32 <header> 33 <nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark"> 34 <a class="navbar-brand" href="../../"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../../images/wand.ico"/></a> 35 <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarsMagick" aria-controls="navbarsMagick" aria-expanded="false" aria-label="Toggle navigation"> 36 <span class="navbar-toggler-icon"></span> 37 </button> 38 39 <div class="navbar-collapse collapse" id="navbarsMagick" style=""> 40 <ul class="navbar-nav mr-auto"> 41 <li class="nav-item "> 42 <a class="nav-link" href="quantize.html">Home <span class="sr-only">(current)</span></a> 43 </li> 44 <li class="nav-item "> 45 <a class="nav-link" href="../../www/download.html">Download</a> 46 </li> 47 <li class="nav-item "> 48 <a class="nav-link" href="../../www/command-line-tools.html">Tools</a> 49 </li> 50 <li class="nav-item "> 51 <a class="nav-link" href="../../www/command-line-processing.html">Command-line</a> 52 </li> 53 <li class="nav-item "> 54 <a class="nav-link" href="../../www/resources.html">Resources</a> 55 </li> 56 <li class="nav-item "> 57 <a class="nav-link" href="../../www/develop.html">Develop</a> 58 </li> 59 <li class="nav-item"> 60 <a class="nav-link" target="_blank" href="https://imagemagick.org/discourse-server/">Community</a> 61 </li> 62 </ul> 63 <form class="form-inline my-2 my-lg-0" action="https://imagemagick.org/script/search.php"> 64 <input class="form-control mr-sm-2" type="text" name="q" placeholder="Search" aria-label="Search"> 65 <button class="btn btn-outline-success my-2 my-sm-0" type="submit" name="sa">Search</button> 66 </form> 67 </div> 68 </nav> 69 <div class="container"> 70 <script async="async" src="https://localhost/pagead/js/adsbygoogle.js"></script> <ins class="adsbygoogle" 71 style="display:block" 72 data-ad-client="ca-pub-3129977114552745" 73 data-ad-slot="6345125851" 74 data-ad-format="auto"></ins> 75 <script> 76 (adsbygoogle = window.adsbygoogle || []).push({}); 77 </script> 78 79 </div> 80 </header> 81 <main class="container"> 82 <div class="magick-template"> 83 <div class="magick-header"> 84 <p class="text-center"><a href="attribute.html#GetImageDepth">GetImageDepth</a> • <a href="attribute.html#GetImageQuantumDepth">GetImageQuantumDepth</a> • <a href="attribute.html#GetImageType">GetImageType</a> • <a href="attribute.html#IdentifyImageGray">IdentifyImageGray</a> • <a href="attribute.html#IdentifyImageMonochrome">IdentifyImageMonochrome</a> • <a href="attribute.html#IdentifyImageType">IdentifyImageType</a> • <a href="attribute.html#IsImageGray">IsImageGray</a> • <a href="attribute.html#IsImageMonochrome">IsImageMonochrome</a> • <a href="attribute.html#IsImageOpaque">IsImageOpaque</a> • <a href="attribute.html#SetImageDepth">SetImageDepth</a> • <a href="attribute.html#SetImageType">SetImageType</a></p> 85 86 <h2><a href="../../api/MagickCore/attribute_8c.html" id="GetImageDepth">GetImageDepth</a></h2> 87 88 <p>GetImageDepth() returns the depth of a particular image channel.</p> 89 90 <p>The format of the GetImageDepth method is:</p> 91 92 <pre class="text"> 93 size_t GetImageDepth(const Image *image,ExceptionInfo *exception) 94 </pre> 95 96 <p>A description of each parameter follows:</p> 97 98 <dd> 99 </dd> 100 101 <dd> </dd> 102 <dl class="dl-horizontal"> 103 <dt>image</dt> 104 <dd>the image. </dd> 105 106 <dd> </dd> 107 <dt>exception</dt> 108 <dd>return any errors or warnings in this structure. </dd> 109 110 <dd> </dd> 111 </dl> 112 <h2><a href="../../api/MagickCore/attribute_8c.html" id="GetImageQuantumDepth">GetImageQuantumDepth</a></h2> 113 114 <p>GetImageQuantumDepth() returns the depth of the image rounded to a legal quantum depth: 8, 16, or 32.</p> 115 116 <p>The format of the GetImageQuantumDepth method is:</p> 117 118 <pre class="text"> 119 size_t GetImageQuantumDepth(const Image *image, 120 const MagickBooleanType constrain) 121 </pre> 122 123 <p>A description of each parameter follows:</p> 124 125 <dd> 126 </dd> 127 128 <dd> </dd> 129 <dl class="dl-horizontal"> 130 <dt>image</dt> 131 <dd>the image. </dd> 132 133 <dd> </dd> 134 <dt>constrain</dt> 135 <dd>A value other than MagickFalse, constrains the depth to a maximum of MAGICKCORE_QUANTUM_DEPTH. </dd> 136 137 <dd> </dd> 138 </dl> 139 <h2><a href="../../api/MagickCore/attribute_8c.html" id="GetImageType">GetImageType</a></h2> 140 141 <p>GetImageType() returns the type of image:</p> 142 143 <p>Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte</p> 144 145 <p>The format of the GetImageType method is:</p> 146 147 <pre class="text"> 148 ImageType GetImageType(const Image *image) 149 </pre> 150 151 <p>A description of each parameter follows:</p> 152 153 <dd> 154 </dd> 155 156 <dd> </dd> 157 <dl class="dl-horizontal"> 158 <dt>image</dt> 159 <dd>the image. </dd> 160 161 <dd> </dd> 162 </dl> 163 <h2><a href="../../api/MagickCore/attribute_8c.html" id="IdentifyImageGray">IdentifyImageGray</a></h2> 164 165 <p>IdentifyImageGray() returns grayscale if all the pixels in the image have the same red, green, and blue intensities, and bi-level is the intensity is either 0 or QuantumRange. Otherwise undefined is returned.</p> 166 167 <p>The format of the IdentifyImageGray method is:</p> 168 169 <pre class="text"> 170 ImageType IdentifyImageGray(const Image *image,ExceptionInfo *exception) 171 </pre> 172 173 <p>A description of each parameter follows:</p> 174 175 <dd> 176 </dd> 177 178 <dd> </dd> 179 <dl class="dl-horizontal"> 180 <dt>image</dt> 181 <dd>the image. </dd> 182 183 <dd> </dd> 184 <dt>exception</dt> 185 <dd>return any errors or warnings in this structure. </dd> 186 187 <dd> </dd> 188 </dl> 189 <h2><a href="../../api/MagickCore/attribute_8c.html" id="IdentifyImageMonochrome">IdentifyImageMonochrome</a></h2> 190 191 <p>IdentifyImageMonochrome() returns MagickTrue if all the pixels in the image have the same red, green, and blue intensities and the intensity is either 0 or QuantumRange.</p> 192 193 <p>The format of the IdentifyImageMonochrome method is:</p> 194 195 <pre class="text"> 196 MagickBooleanType IdentifyImageMonochrome(const Image *image, 197 ExceptionInfo *exception) 198 </pre> 199 200 <p>A description of each parameter follows:</p> 201 202 <dd> 203 </dd> 204 205 <dd> </dd> 206 <dl class="dl-horizontal"> 207 <dt>image</dt> 208 <dd>the image. </dd> 209 210 <dd> </dd> 211 <dt>exception</dt> 212 <dd>return any errors or warnings in this structure. </dd> 213 214 <dd> </dd> 215 </dl> 216 <h2><a href="../../api/MagickCore/attribute_8c.html" id="IdentifyImageType">IdentifyImageType</a></h2> 217 218 <p>IdentifyImageType() returns the potential type of image:</p> 219 220 <p>Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte</p> 221 222 <p>To ensure the image type matches its potential, use SetImageType():</p> 223 224 <pre class="text"> 225 (void) SetImageType(image,IdentifyImageType(image,exception),exception); 226 </pre> 227 228 <p>The format of the IdentifyImageType method is:</p> 229 230 <pre class="text"> 231 ImageType IdentifyImageType(const Image *image,ExceptionInfo *exception) 232 </pre> 233 234 <p>A description of each parameter follows:</p> 235 236 <dd> 237 </dd> 238 239 <dd> </dd> 240 <dl class="dl-horizontal"> 241 <dt>image</dt> 242 <dd>the image. </dd> 243 244 <dd> </dd> 245 <dt>exception</dt> 246 <dd>return any errors or warnings in this structure. </dd> 247 248 <dd> </dd> 249 </dl> 250 <h2><a href="../../api/MagickCore/attribute_8c.html" id="IsImageGray">IsImageGray</a></h2> 251 252 <p>IsImageGray() returns MagickTrue if the type of the image is grayscale or bi-level.</p> 253 254 <p>The format of the IsImageGray method is:</p> 255 256 <pre class="text"> 257 MagickBooleanType IsImageGray(const Image *image) 258 </pre> 259 260 <p>A description of each parameter follows:</p> 261 262 <dd> 263 </dd> 264 265 <dd> </dd> 266 <dl class="dl-horizontal"> 267 <dt>image</dt> 268 <dd>the image. </dd> 269 270 <dd> </dd> 271 </dl> 272 <h2><a href="../../api/MagickCore/attribute_8c.html" id="IsImageMonochrome">IsImageMonochrome</a></h2> 273 274 <p>IsImageMonochrome() returns MagickTrue if type of the image is bi-level.</p> 275 276 <p>The format of the IsImageMonochrome method is:</p> 277 278 <pre class="text"> 279 MagickBooleanType IsImageMonochrome(const Image *image) 280 </pre> 281 282 <p>A description of each parameter follows:</p> 283 284 <dd> 285 </dd> 286 287 <dd> </dd> 288 <dl class="dl-horizontal"> 289 <dt>image</dt> 290 <dd>the image. </dd> 291 292 <dd> </dd> 293 </dl> 294 <h2><a href="../../api/MagickCore/attribute_8c.html" id="IsImageOpaque">IsImageOpaque</a></h2> 295 296 <p>IsImageOpaque() returns MagickTrue if none of the pixels in the image have an alpha value other than OpaqueAlpha (QuantumRange).</p> 297 298 <p>Will return true immediatally is alpha channel is not available.</p> 299 300 <p>The format of the IsImageOpaque method is:</p> 301 302 <pre class="text"> 303 MagickBooleanType IsImageOpaque(const Image *image, 304 ExceptionInfo *exception) 305 </pre> 306 307 <p>A description of each parameter follows:</p> 308 309 <dd> 310 </dd> 311 312 <dd> </dd> 313 <dl class="dl-horizontal"> 314 <dt>image</dt> 315 <dd>the image. </dd> 316 317 <dd> </dd> 318 <dt>exception</dt> 319 <dd>return any errors or warnings in this structure. </dd> 320 321 <dd> </dd> 322 </dl> 323 <h2><a href="../../api/MagickCore/attribute_8c.html" id="SetImageDepth">SetImageDepth</a></h2> 324 325 <p>SetImageDepth() sets the depth of the image.</p> 326 327 <p>The format of the SetImageDepth method is:</p> 328 329 <pre class="text"> 330 MagickBooleanType SetImageDepth(Image *image,const size_t depth, 331 ExceptionInfo *exception) 332 </pre> 333 334 <p>A description of each parameter follows:</p> 335 336 <dd> 337 </dd> 338 339 <dd> </dd> 340 <dl class="dl-horizontal"> 341 <dt>image</dt> 342 <dd>the image. </dd> 343 344 <dd> </dd> 345 <dt>channel</dt> 346 <dd>the channel. </dd> 347 348 <dd> </dd> 349 <dt>depth</dt> 350 <dd>the image depth. </dd> 351 352 <dd> </dd> 353 <dt>exception</dt> 354 <dd>return any errors or warnings in this structure. </dd> 355 356 <dd> </dd> 357 </dl> 358 <h2><a href="../../api/MagickCore/attribute_8c.html" id="SetImageType">SetImageType</a></h2> 359 360 <p>SetImageType() sets the type of image. Choose from these types:</p> 361 362 <p>Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte OptimizeType</p> 363 364 <p>The format of the SetImageType method is:</p> 365 366 <pre class="text"> 367 MagickBooleanType SetImageType(Image *image,const ImageType type, 368 ExceptionInfo *exception) 369 </pre> 370 371 <p>A description of each parameter follows:</p> 372 373 <dd> 374 </dd> 375 376 <dd> </dd> 377 <dl class="dl-horizontal"> 378 <dt>image</dt> 379 <dd>the image. </dd> 380 381 <dd> </dd> 382 <dt>type</dt> 383 <dd>Image type. </dd> 384 385 <dd> </dd> 386 <dt>exception</dt> 387 <dd>return any errors or warnings in this structure. </dd> 388 389 <dd> </dd> 390 </dl> 391 </div> 392 </div> 393 </main><!-- /.container --> 394 <footer class="magick-footer"> 395 <p><a href="../../www/security-policy.html">Security</a> 396 <a href="../../www/architecture.html">Architecture</a> 397 <a href="../../www/links.html">Related</a> 398 <a href="../../www/sitemap.html">Sitemap</a> 399 400 <a href="attribute.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../../images/wand.ico"/></a> 401 402 <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> 403 <a href="../../www/support.html">Donate</a> 404 <a href="../../www/contact.html">Contact Us</a> 405 <br/> 406 <small> 1999-2019 ImageMagick Studio LLC</small></p> 407 </footer> 408 409 <!-- Javascript assets --> 410 <script src="../assets/magick.js" crossorigin="anonymous"></script> 411 <script>window.jQuery || document.write('<script src="https://localhost/ajax/libs/jquery/3.3.1/jquery.min.js"><\/script>')</script> 412 </body> 413 </html> 414 <!-- Magick Cache 3rd January 2019 05:28 -->
