| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246 |
- <!doctype html>
- <html lang="en">
- <head>
- <meta charset="utf-8" />
- <meta name="viewport" content="width=device-width, initial-scale=1" />
- <title>ImageMagick – MagickCore, C API: Read or List Image formats</title>
- <meta name="application-name" content="ImageMagick" />
- <meta name="description" content="" />
- <meta name="application-url" content="https://imagemagick.org" />
- <meta name="generator" content="PHP" />
- <meta name="keywords" content="magickcore, c, api:, read, or, list, image, formats, image processing software" />
- <meta name="rating" content="GENERAL" />
- <meta name="robots" content="INDEX, FOLLOW" />
- <meta name="generator" content="ImageMagick Studio LLC" />
- <meta name="author" content="ImageMagick Studio LLC" />
- <meta name="revisit-after" content="2 DAYS" />
- <meta name="resource-type" content="document" />
- <meta name="copyright" content="Copyright (c) 1999 ImageMagick Studio LLC" />
- <meta name="distribution" content="Global" />
- <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
- <meta property='og:url' content='../../' />
- <meta property='og:title' content='ImageMagick' />
- <meta property='og:image' content='../../../images/logo.png' />
- <meta property='og:type' content='website' />
- <meta property='og:site_name' content='ImageMagick' />
- <meta property='og:description' content="Create, Edit, Compose, or Convert Digital Images" />
- <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
- <link href="magick.html" rel="canonical" />
- <link href="../../../images/wand.png" rel="icon" />
- <link href="../../../images/wand.ico" rel="shortcut icon" />
- <link href="../../assets/magick.css" rel="stylesheet" />
- </head>
- <body>
- <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top">
- <div class="container-fluid">
- <a class="navbar-brand" href="../../"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../../../images/wand.ico"/></a>
- <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#magick-navbars" aria-controls="magick-navbars" aria-expanded="false" aria-label="Toggle navigation">
- <span class="navbar-toggler-icon"></span>
- </button>
- <div class="collapse navbar-collapse" id="magick-navbars">
- <ul class="navbar-nav me-auto mb-2 mb-md-0">
- <li class="nav-item">
- <a class="nav-link " href="../../www/download.html">Download</a>
- </li>
- <li class="nav-item">
- <a class="nav-link " href="../../www/command-line-tools.html">Tools</a>
- </li>
- <li class="nav-item">
- <a class="nav-link " href="../../www/command-line-processing.html">CLI</a>
- </li>
- <li class="nav-item">
- <a class="nav-link " href="../../www/develop.html">Develop</a>
- </li>
- <li class="nav-item">
- <a class="nav-link" target="_blank" href="https://github.com/ImageMagick/ImageMagick/discussions">Community</a>
- </li>
- <li class="nav-item">
- <iframe src="https://github.com/sponsors/ImageMagick/button" title="Sponsor ImageMagick" height="35" width="107" style="border: 0;"></iframe>
- </li>
- </ul>
- <form class="d-flex form-inline" action="https://imagemagick.org/script/search.php">
- <input class="form-control me-2" type="text" name="q" placeholder="Search" aria-label="Search">
- <button class="btn btn-outline-success" type="submit" name="sa">Search</button>
- </form>
- </div>
- </div>
- </nav>
- <div class="container">
- <script async="async" src="https://localhost/pagead/js/adsbygoogle.js"></script>
- <ins class="adsbygoogle"
- style="display:block"
- data-ad-client="ca-pub-3129977114552745"
- data-ad-slot="6345125851"
- data-full-width-responsive="true"
- data-ad-format="horizontal"></ins>
- <script>
- (adsbygoogle = window.adsbygoogle || []).push({});
- </script>
- </div>
- <main class="container">
- <div class="magick-template">
- <br/>
- <div class="btn-group">
- <button class="btn btn-secondary dropdown-toggle" type="button" id="defaultDropdown" data-bs-toggle="dropdown" data-bs-auto-close="true" aria-expanded="false">
- Select API Method
- </button>
- <ul class="dropdown-menu pre-scrollable" aria-labelledby="defaultDropdown">
- <li><a href="magick.html#AcquireMagickInfo">AcquireMagickInfo</a></li>
- <li><a href="magick.html#GetMagickPrecision">GetMagickPrecision</a></li>
- <li><a href="magick.html#IsMagickCoreInstantiated">IsMagickCoreInstantiated</a></li>
- <li><a href="magick.html#MagickCoreGenesis">MagickCoreGenesis</a></li>
- <li><a href="magick.html#MagickCoreTerminus">MagickCoreTerminus</a></li>
- </ul>
- </div>
- <br/>
- <br/>
- <div class="magick-header">
- <h2><a href="../../api/MagickCore/magick_8c.html" id="AcquireMagickInfo">AcquireMagickInfo</a></h2>
- <p>AcquireMagickInfo() allocates a MagickInfo structure and initializes the members to default values.</p>
- <p>The format of the AcquireMagickInfo method is:</p>
- <pre class="bg-light text-dark mx-4"><samp>MagickInfo *AcquireMagickInfo(const char *magick_module,
- const char *name,const char *description)
- </samp></pre>
- <p>A description of each parameter follows:</p>
- <dd>
- </dd>
- <dd> </dd>
- <dl class="dl-horizontal">
- <dt>magick_module</dt>
- <dd>a character string that represents the module associated with the MagickInfo structure. </dd>
- <dd> </dd>
- <dt>name</dt>
- <dd>a character string that represents the image format associated with the MagickInfo structure. </dd>
- <dd> </dd>
- <dt>description</dt>
- <dd>a character string that represents the image format associated with the MagickInfo structure. </dd>
- <dd> </dd>
- </dl>
- <h2><a href="../../api/MagickCore/magick_8c.html" id="GetMagickPrecision">GetMagickPrecision</a></h2>
- <p>GetMagickPrecision() returns the maximum number of significant digits to be printed.</p>
- <p>The format of the GetMagickPrecision method is:</p>
- <pre class="bg-light text-dark mx-4"><samp>int GetMagickPrecision(void)
- </samp></pre>
- <h2><a href="../../api/MagickCore/magick_8c.html" id="IsMagickCoreInstantiated">IsMagickCoreInstantiated</a></h2>
- <p>IsMagickCoreInstantiated() returns MagickFalse if the ImageMagick environment has not been instantiated; the ImageMagick environment has been instantiated when MagickCoreGenesis() has been called but MagickDestroy() has not been called.</p>
- <p>The format of the IsMagickCoreInstantiated method is:</p>
- <pre class="bg-light text-dark mx-4"><samp>MagickBooleanType IsMagickCoreInstantiated(void)
- </samp></pre>
- <h2><a href="../../api/MagickCore/magick_8c.html" id="MagickCoreGenesis">MagickCoreGenesis</a></h2>
- <p>MagickCoreGenesis() initializes the MagickCore environment.</p>
- <p>The format of the MagickCoreGenesis function is:</p>
- <pre class="bg-light text-dark mx-4"><samp>MagickCoreGenesis(const char *path,
- const MagickBooleanType establish_signal_handlers)
- </samp></pre>
- <p>A description of each parameter follows:</p>
- <dd>
- </dd>
- <dd> </dd>
- <dl class="dl-horizontal">
- <dt>path</dt>
- <dd>the execution path of the current ImageMagick client. </dd>
- <dd> </dd>
- <dt>establish_signal_handlers</dt>
- <dd>set to MagickTrue to use MagickCore's own signal handlers for common signals. </dd>
- <dd> </dd>
- </dl>
- <h2><a href="../../api/MagickCore/magick_8c.html" id="MagickCoreTerminus">MagickCoreTerminus</a></h2>
- <p>MagickCoreTerminus() is a function in the ImageMagick library that is used to clean up and release resources when shutting down an application that uses ImageMagick. This function should be called in the primary thread of the application's process during the shutdown process. It's crucial that this function is invoked only after any threads that are using ImageMagick functions have terminated.</p>
- <p>ImageMagick might internally use threads via OpenMP (a method for parallel programming). As a result, it's important to ensure that any function calls into ImageMagick have completed before calling MagickCoreTerminus(). This prevents issues with OpenMP worker threads accessing resources that are destroyed by this termination function.</p>
- <p>If OpenMP is being used (starting from version 5.0), the OpenMP implementation itself handles starting and stopping worker threads and allocating and freeing resources using its own methods. This means that after calling MagickCoreTerminus(), some OpenMP resources and worker threads might still remain allocated. To address this, the function omp_pause_resource_all(omp_pause_hard) can be invoked. This function, introduced in OpenMP version 5.0, ensures that any resources allocated by OpenMP (such as threads and thread-specific memory) are freed. It's recommended to call this function after MagickCoreTerminus() has completed its execution.</p>
- <p>The format of the MagickCoreTerminus function is:</p>
- <pre class="bg-light text-dark mx-4"><samp>MagickCoreTerminus(void)
- </samp></pre>
- <h2><a href="../../api/MagickCore/magick_8c.html" id="SetMagickPrecision">SetMagickPrecision</a></h2>
- <p>SetMagickPrecision() sets the maximum number of significant digits to be printed.</p>
- <p>An input argument of 0 returns the current precision setting.</p>
- <p>A negative value forces the precision to reset to a default value according to the environment variable "MAGICK_PRECISION", the current 'policy' configuration setting, or the default value of '6', in that order.</p>
- <p>The format of the SetMagickPrecision method is:</p>
- <pre class="bg-light text-dark mx-4"><samp>int SetMagickPrecision(const int precision)
- </samp></pre>
- <p>A description of each parameter follows:</p>
- <dd>
- </dd>
- <dd> </dd>
- <dl class="dl-horizontal">
- <dt>precision</dt>
- <dd>set the maximum number of significant digits to be printed. </dd>
- <dd> </dd>
- </dl>
- </div>
- </div>
- </main><!-- /.container -->
- <footer class="magick-footer">
- <div class="container-fluid">
- <a href="../../www/security-policy.html">Security</a> •
- <a href="../../www/news.html">News</a>
-
- <a href="magick.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../../../images/wand.ico"/></a>
-
- <a href="../../www/links.html">Related</a> •
- <a href="../../www/sitemap.html">Sitemap</a>
- <br/>
- <a href="../../www/support.html">Sponsor</a> •
- <a href="../../www/cite.html">Cite</a> •
- <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
- <a href="../../www/contact.html">Contact Us</a>
- <br/>
- <a href="https://github.com/imagemagick/imagemagick" target="_blank" rel="noopener" aria-label="GitHub"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 499.36" width="2%" height="2%" role="img" focusable="false"><title>GitHub</title><path fill="currentColor" fill-rule="evenodd" d="M256 0C114.64 0 0 114.61 0 256c0 113.09 73.34 209 175.08 242.9 12.8 2.35 17.47-5.56 17.47-12.34 0-6.08-.22-22.18-.35-43.54-71.2 15.49-86.2-34.34-86.2-34.34-11.64-29.57-28.42-37.45-28.42-37.45-23.27-15.84 1.73-15.55 1.73-15.55 25.69 1.81 39.21 26.38 39.21 26.38 22.84 39.12 59.92 27.82 74.5 21.27 2.33-16.54 8.94-27.82 16.25-34.22-56.84-6.43-116.6-28.43-116.6-126.49 0-27.95 10-50.8 26.35-68.69-2.63-6.48-11.42-32.5 2.51-67.75 0 0 21.49-6.88 70.4 26.24a242.65 242.65 0 0 1 128.18 0c48.87-33.13 70.33-26.24 70.33-26.24 14 35.25 5.18 61.27 2.55 67.75 16.41 17.9 26.31 40.75 26.31 68.69 0 98.35-59.85 120-116.88 126.32 9.19 7.9 17.38 23.53 17.38 47.41 0 34.22-.31 61.83-.31 70.23 0 6.85 4.61 14.81 17.6 12.31C438.72 464.97 512 369.08 512 256.02 512 114.62 397.37 0 256 0z"/></svg></a> •
- <a href="https://twitter.com/imagemagick" target="_blank" rel="noopener" aria-label="Twitter"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 300 300" width="2%" height="2%" role="img" focusable="false"><title>Twitter</title><path d="M178.57 127.15 290.27 0h-26.46l-97.03 110.38L89.34 0H0l117.13 166.93L0 300.25h26.46l102.4-116.59 81.8 116.59h89.34M36.01 19.54H76.66l187.13 262.13h-40.66"/></svg></a>
- <br/>
- <small>Copyright © 1999 ImageMagick Studio LLC</small>
- </div>
- </footer>
- <!-- Javascript assets -->
- <script src="../../assets/magick.js" ></script>
- </body>
- </html>
|