Управление памятью

С++

Все интерфейсные объекты хранятся в умных указателях (см. pbio::LightSmartPtr и pbio::HeavySmartPtr). Для удобства каждый интерфейсный объект T объявляет собственный тип указателя T::Ptr (например, pbio::Template::Ptr), поэтому не используйте pbio::LightSmartPtr или pbio::HeavySmartPtr напрямую. Большинство объектов используют pbio::LightSmartPtr, который в целях значительного снижения потребления памяти не позволяет хранить наследованные типы или использовать особый deleter.

Если вы используете OpenCV / boost / C++11, то можете определить один из перечисленных ниже макросов, чтобы настроить libfacerec на использование определенного типа указателей вместо pbio::HeavySmartPtr:

• PBIO_OPENCV_SMART_POINTER - для использования cv::Ptr,
• PBIO_BOOST_SMART_POINTER - для использования boost::shared_ptr,
• PBIO_CXX11_SMART_POINTER - для использования std::shared_ptr.

Если ни один из этих макросов не определен, будет использован указатель, определенный в pbio/shared_ptr/heavy_shared_ptr.h - усеченная версия умного указателя из OpenCV, не требующая использования OpenCV.

Во всех случаях T::Ptr является потокобезопасным умным указателем.

Библиотека libfacerec автоматически выгрузится, когда не останется интерфейсных объектов.

Java

Для освобождения памяти от внутренних объектов до того, как это автоматически сделает сборщик мусора, используйте метод dispose(). После вызова этого метода от объекта можно будет вызвать только метод isDisposed(). В случае вызова любого другого метода будет выброшено исключение.

Пример:

...
Capturer capturer = service.createCapturer(service.new Config("common_capturer.xml"));
...
capturer.dispose(); // release internal objects
if (capturer.isDisposed())
{
    System.out.println("object is disposed");
}
capturer.capture(image); // exception, object is disposed
// this line never be reached

C#

Для освобождения памяти от внутренних объектов до того, как это автоматически сделает сборщик мусора, используйте метод Dispose(). После вызова этого метода объект может получать только значения свойства IsDisposed, в противном случае будет выброшено исключение.

Пример:

...
Capturer capturer = service.createCapturer("common_capturer.xml");
...
capturer.Dispose(); // release internal objects
if (capturer.IsDisposed)
{
    Console.WriteLine("object is disposed");
}
capturer.capture(image); // exception, object is disposed
// this line never be reached

Python

Для освобождения памяти от внутренних объектов используются деструкторы. Сборщик мусора автоматически освобождает память, когда это необходимо.

Пример:

...
capturer = service.create_capturer("common_capturer.xml")
...
del capturer  # release internal objects

capturer.capture(image)  # exception, object is disposed
# this line never be reached