> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IPictureObject

> IPictureObject representa una imagen de una página o región en los scripts de FlexiCapture, con métodos para analizar objetos, comprobar si es adecuada para OCR y detectar la orientación.

<div id="what-it-does">
  ## Descripción
</div>

Representa la imagen de una página o una región.

El objeto implementa la interfaz IPicture y proporciona acceso a algunas de sus propiedades a través de la interfaz IDispatch.

Para obtener más información sobre la interfaz IPicture, consulte el artículo correspondiente en [MSDN](https://msdn.microsoft.com/en-us/library/ms680761\(VS.85\).aspx#methods).

<Note>
  Este objeto no está disponible en la estación web de verificación para verificar reglas localmente.
</Note>

<div id="methods">
  ## Métodos
</div>

<table width="100%"><thead><tr><th style={{textAlign: 'left'}}><p><strong>Definición</strong></p></th><th style={{textAlign: 'left'}}><p><strong>Descripción</strong></p></th></tr></thead><tbody><tr><td><p>AnalyzePageObjects( \[optional] reserved: Object ) : <a href="/es/flexi-capture/appendix/scripts/i-picture-objects-info">IPictureObjectsInfo</a></p></td><td><p>Define los objetos de la página y devuelve los parámetros de la página según los interpreta el módulo de reconocimiento. La operación puede tardar algo de tiempo.</p></td></tr><tr><td><p>CalcSuitabilityForOCR(): float</p></td><td><p>Muestra hasta qué punto una imagen es adecuada para OCR. Los valores posibles van de 0.0 a 1.0.</p><details><summary>Ejemplo</summary><p>Este script registra los resultados de la operación del método para los documentos seleccionados en un comentario de la página al hacer clic en un botón de usuario:</p><pre><code>foreach( IDocument doc in MainWindow\.Selection.Documents )
\{
MainWindow\.TaskWindow\.OpenDocument( doc );
foreach( IPage page in doc.Pages )
\{
IPictureObject picture = page.Picture;
       double score = (double)picture.CalcSuitabilityForOCR();
       bool verdict = (bool)picture.IsSuitableForOcr();
       page.Comment = score.ToString( "0.0000" ) + " / " + verdict.ToString();
}
}</code></pre></details></td></tr><tr><td><p>CreateEditableCopy() : <a href="/es/flexi-capture/appendix/scripts/ieditablepictureobject">IEditablePictureObject</a></p></td><td><p>Crea una copia editable de la imagen.</p></td></tr><tr><td><p>DetectPageOrientation( \[optional] language: string ) : int</p></td><td><p>Detecta la orientación de la página a partir del texto que contiene. El <a href="/es/flexi-capture/appendix/scripts/internal-lang">nombre interno</a> del idioma se pasa como parámetro de entrada. Si no se especifica el idioma, se utiliza el idioma de la configuración regional actual. Devuelve el ángulo (en grados) al que debe girarse la página. Se pueden devolver los siguientes valores: 0, 90, 180 y 270.</p></td></tr><tr><td><p>IsPhoto(): bool</p></td><td><p>Indica si una imagen es una foto.</p></td></tr><tr><td><p>IsSuitableForOcr(): bool</p></td><td><p>Indica si una imagen es adecuada para OCR.</p></td></tr><tr><td><p>SaveAs( filename : string, \[optional] options : <a href="/es/flexi-capture/appendix/scripts/iexportimagesavingoptions">IExportImageSavingOptions</a> )</p></td><td><p>Guarda la imagen. Si no se especifica ninguna opción, la imagen se guarda como \*.tif.</p></td></tr></tbody></table>

<div id="properties">
  ## Propiedades
</div>

<table width="100%">
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        <p>
          <strong>Nombre</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>Tipo</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>Acceso</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>Descripción</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>Handle</p>
      </td>

      <td>
        <p>OLE\_HANDLE</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>El handle GDI de Windows de la imagen.</p>
        <p>En .NET, esta propiedad puede usarse en el método System.Drawing.Image.FromHbitmap para obtener el objeto de imagen.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Height</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>La altura de la imagen en puntos</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>hPal</p>
      </td>

      <td>
        <p>OLE\_HANDLE</p>
      </td>

      <td>
        <p>Lectura/escritura, mutable (se puede modificar incluso en scripts con permisos de solo lectura)</p>
      </td>

      <td>
        <p>El handle de Windows de la paleta utilizada por la imagen.</p>
        <p>Esta propiedad puede usarse en System.Drawing.Image.FromHbitmap como segundo parámetro.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsBlackWhite</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>Indica si la imagen es en blanco y negro.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsColor</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>Indica si la imagen es en color.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsGrayscale</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>Indica si la imagen es en escala de grises.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Type</p>
      </td>

      <td>
        <p>SHORT</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>El tipo de imagen.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Width</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>El ancho de la imagen en puntos</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>XResolution</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>La resolución horizontal de la imagen</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>YResolution</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>De solo lectura</p>
      </td>

      <td>
        <p>La resolución vertical de la imagen</p>
      </td>
    </tr>
  </tbody>
</table>
