THPDFLoadedPageRenderSession Class

Säilyttää sivun renderöintitilan ja elävän osittaisen bitmapin, jotta ladattu sivu voidaan renderöidä useassa rajatussa kutsussa

Määrittely

THPDFLoadedPageRenderSession = class(TObject)
public
  function ContinueRender(MaxMilliseconds: Cardinal = 0;
    MaxObjects: Integer = 0): THPDFProgressiveRenderStatus;
  function TakeBitmap: TBitmap;
  property Bitmap: TBitmap read GetBitmap;
  property ObjectsProcessed: Integer read GetObjectsProcessed;
  property TotalObjects: Integer read GetTotalObjects;
  property ProgressiveJPEGScansDecoded: Integer
    read GetProgressiveJPEGScansDecoded;
  property ProgressiveJPEGImagesDecoded: Integer
    read GetProgressiveJPEGImagesDecoded;
  property Status: THPDFProgressiveRenderStatus read GetStatus;
  property IsRegionRender: Boolean read FIsRegionRender;
  property RegionLeft: Single read FRegionLeft;
  property RegionBottom: Single read FRegionBottom;
  property RegionRight: Single read FRegionRight;
  property RegionTop: Single read FRegionTop;
  property RegionVisiblePaintObjects: Integer
    read GetRegionVisiblePaintObjects;
  property RegionCulledPaintObjects: Integer
    read GetRegionCulledPaintObjects;
  property OnProgress: THPDFProgressiveRenderProgressEvent
    read FOnProgress write SetOnProgress;
  property OnProgressiveJPEGScan: THPDFProgressiveJPEGScanEvent
    read FOnProgressiveJPEGScan write SetOnProgressiveJPEGScan;
end;

Yksikkö

HPDFDoc

Tila-arvot

• prsReady tarkoittaa, että sivu on alustettu eikä yhtään sisältöoperaattoria ole suoritettu
• prsPaused tarkoittaa, että budjetti loppui ennen kuin kaikki operaattorit valmistuivat
• prsCompleted tarkoittaa, että kokonainen sivubitmap on saatavilla
• prsCancelled tarkoittaa, että callback tai token pysäytti session operaattorirajalla

Käyttöhuomautukset

• Kumpi tahansa budjetti saa olla nolla rajattomalle työlle, ja molemmat nollat ajavat yhdessä kutsussa lopputilaan asti
• Bitmap pysyy session omistuksessa ja on tarkoitettu vain luku -esikatselukäyttöön
• TakeBitmap on kelvollinen vain lopputilassa ja siirtää omistuksen kutsujalle
• ProgressiveJPEGScansDecoded ja ProgressiveJPEGImagesDecoded laskevat onnistuneen inkrementaalisen kuvatyön, ja OnProgressiveJPEGScan voi keskeyttää näkyvän skanliviivan jälkeen
• IsRegionRender identifioi ROI-sessiot; alueominaisuudet säilyttävät pyydetyt käyttäjätilan rajat, ja näkyvien sekä karsittujen laskurit kuvailevat display listan piirtovalintaa
• ladatun THotPDF-instanssin ja keskeytystokenin on pysyttävä elossa, kunnes sessio vapautetaan

Aiheeseen liittyvät API:t

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Progressiivinen renderöinti ja keskeytys