tesseract::DocumentData Class Reference

#include <imagedata.h>

Public Member Functions
	DocumentData (const STRING &name)
	~DocumentData ()
bool	LoadDocument (const char *filename, const char *lang, int start_page, inT64 max_memory, FileReader reader)
void	SetDocument (const char *filename, const char *lang, inT64 max_memory, FileReader reader)
bool	SaveDocument (const char *filename, FileWriter writer)
bool	SaveToBuffer (GenericVector< char > *buffer)
void	AddPageToDocument (ImageData *page)
const STRING &	document_name () const
int	NumPages () const
inT64	memory_used () const
void	LoadPageInBackground (int index)
const ImageData *	GetPage (int index)
bool	IsPageAvailable (int index, ImageData **page)
ImageData *	TakePage (int index)
bool	IsCached () const
inT64	UnCache ()

Friends
void *	ReCachePagesFunc (void *data)

Detailed Description

Definition at line 204 of file imagedata.h.

Constructor & Destructor Documentation

DocumentData()

tesseract::DocumentData::DocumentData ( const STRING &  name )

explicit

Definition at line 372 of file imagedata.cpp.

    : document_name_(name),
      pages_offset_(-1),
      total_pages_(-1),
      memory_used_(0),
      max_memory_(0),
      reader_(NULL) {}

~DocumentData()

tesseract::DocumentData::~DocumentData

(

)

Definition at line 380 of file imagedata.cpp.

                            {
  SVAutoLock lock_p(&pages_mutex_);
  SVAutoLock lock_g(&general_mutex_);
}

Member Function Documentation

AddPageToDocument()

void tesseract::DocumentData::AddPageToDocument

(

ImageData *

page

)

Definition at line 426 of file imagedata.cpp.

                                                    {
  SVAutoLock lock(&pages_mutex_);
  pages_.push_back(page);
  set_memory_used(memory_used() + page->MemoryUsed());
}

document_name()

const STRING& tesseract::DocumentData::document_name ( ) const

inline

Definition at line 225 of file imagedata.h.

                                      {
    SVAutoLock lock(&general_mutex_);
    return document_name_;
  }

GetPage()

const ImageData * tesseract::DocumentData::GetPage

(

int

index

)

Definition at line 448 of file imagedata.cpp.

                                                {
  ImageData* page = NULL;
  while (!IsPageAvailable(index, &page)) {
    // If there is no background load scheduled, schedule one now.
    pages_mutex_.Lock();
    bool needs_loading = pages_offset_ != index;
    pages_mutex_.Unlock();
    if (needs_loading) LoadPageInBackground(index);
    // We can't directly load the page, or the background load will delete it
    // while the caller is using it, so give it a chance to work.
#if __cplusplus > 199711L && !defined(__MINGW32__)
    std::this_thread::sleep_for(std::chrono::seconds(1));
#elif _WIN32  // MSVS
    Sleep(1000);
#else
    sleep(1);
#endif
  }
  return page;
}

IsCached()

bool tesseract::DocumentData::IsCached ( ) const

inline

Definition at line 265 of file imagedata.h.

{ return NumPages() >= 0; }

IsPageAvailable()

bool tesseract::DocumentData::IsPageAvailable	(	int	index,
		ImageData **	page
	)

Definition at line 472 of file imagedata.cpp.

                                                              {
  SVAutoLock lock(&pages_mutex_);
  int num_pages = NumPages();
  if (num_pages == 0 || index < 0) {
    *page = NULL;  // Empty Document.
    return true;
  }
  if (num_pages > 0) {
    index = Modulo(index, num_pages);
    if (pages_offset_ <= index && index < pages_offset_ + pages_.size()) {
      *page = pages_[index - pages_offset_];  // Page is available already.
      return true;
    }
  }
  return false;
}

LoadDocument()

bool tesseract::DocumentData::LoadDocument	(	const char *	filename,
		const char *	lang,
		int	start_page,
		inT64	max_memory,
		FileReader	reader
	)

Definition at line 387 of file imagedata.cpp.

                                                   {
  SetDocument(filename, lang, max_memory, reader);
  pages_offset_ = start_page;
  return ReCachePages();
}

LoadPageInBackground()

void tesseract::DocumentData::LoadPageInBackground

(

int

index

)

Definition at line 434 of file imagedata.cpp.

                                                 {
  ImageData* page = NULL;
  if (IsPageAvailable(index, &page)) return;
  SVAutoLock lock(&pages_mutex_);
  if (pages_offset_ == index) return;
  pages_offset_ = index;
  pages_.clear();
  #ifndef GRAPHICS_DISABLED
  SVSync::StartThread(ReCachePagesFunc, this);
  #endif  // GRAPHICS_DISABLED
}

memory_used()

inT64 tesseract::DocumentData::memory_used ( ) const

inline

Definition at line 233 of file imagedata.h.

                            {
    SVAutoLock lock(&general_mutex_);
    return memory_used_;
  }

NumPages()

int tesseract::DocumentData::NumPages ( ) const

inline

Definition at line 229 of file imagedata.h.

                       {
    SVAutoLock lock(&general_mutex_);
    return total_pages_;
  }

SaveDocument()

bool tesseract::DocumentData::SaveDocument	(	const char *	filename,
		FileWriter	writer
	)

Definition at line 408 of file imagedata.cpp.

                                                                       {
  SVAutoLock lock(&pages_mutex_);
  TFile fp;
  fp.OpenWrite(NULL);
  if (!pages_.Serialize(&fp) || !fp.CloseWrite(filename, writer)) {
    tprintf("Serialize failed: %s\n", filename);
    return false;
  }
  return true;
}

SaveToBuffer()

bool tesseract::DocumentData::SaveToBuffer

(

GenericVector< char > *

buffer

)

Definition at line 418 of file imagedata.cpp.

                                                           {
  SVAutoLock lock(&pages_mutex_);
  TFile fp;
  fp.OpenWrite(buffer);
  return pages_.Serialize(&fp);
}

SetDocument()

void tesseract::DocumentData::SetDocument	(	const char *	filename,
		const char *	lang,
		inT64	max_memory,
		FileReader	reader
	)

Definition at line 396 of file imagedata.cpp.

                                                                    {
  SVAutoLock lock_p(&pages_mutex_);
  SVAutoLock lock(&general_mutex_);
  document_name_ = filename;
  lang_ = lang;
  pages_offset_ = -1;
  max_memory_ = max_memory;
  reader_ = reader;
}

TakePage()

ImageData* tesseract::DocumentData::TakePage ( int  index )

inline

Definition at line 257 of file imagedata.h.

                                 {
    SVAutoLock lock(&pages_mutex_);
    ImageData* page = pages_[index];
    pages_[index] = NULL;
    return page;
  }

UnCache()

inT64 tesseract::DocumentData::UnCache

(

)

Definition at line 491 of file imagedata.cpp.

                            {
  SVAutoLock lock(&pages_mutex_);
  inT64 memory_saved = memory_used();
  pages_.clear();
  pages_offset_ = -1;
  set_total_pages(-1);
  set_memory_used(0);
  tprintf("Unloaded document %s, saving %d memory\n", document_name_.string(),
          memory_saved);
  return memory_saved;
}

Friends And Related Function Documentation

ReCachePagesFunc

void* ReCachePagesFunc ( void *  data )

friend

Definition at line 366 of file imagedata.cpp.

                                   {
  DocumentData* document_data = reinterpret_cast<DocumentData*>(data);
  document_data->ReCachePages();
  return NULL;
}

---

The documentation for this class was generated from the following files:

• ccstruct/imagedata.h
• ccstruct/imagedata.cpp