com.compdfkit.ui.reader

Class CPDFSingleLayoutManager

java.lang.Object

com.compdfkit.ui.reader.CPDFLayoutManager

com.compdfkit.ui.reader.CPDFSingleLayoutManager

public class CPDFSingleLayoutManager
extends CPDFLayoutManager

Calculates page rectangles for page-by-page reader modes.

This layout manager is used when the reader presents one logical screen at a time. It supports vertical and horizontal paging, single-page mode, double-page mode, and double-page mode with a separate cover page. Unlike the continuous manager, most branches size each page or pair against the viewport so that page snapping can use stable screen-sized steps.

The manager only produces geometry. Page drawing, scrolling, snapping, and user interaction are handled elsewhere by ReaderView. Calculated page rectangles are stored in pageLocations; aggregate bounds are stored in contentWidth and contentHeight.

Constructor Summary

Constructors

Constructor and Description
CPDFSingleLayoutManager() Creates a single-page layout manager without binding it to a reader view.
CPDFSingleLayoutManager(ReaderView readerView) Deprecated.

Method Summary

Modifier and Type	Method and Description
float	getContentHeight() Returns the total content height calculated by the last refresh() call.
float	getContentWidth() Returns the total content width calculated by the last refresh() call.
android.graphics.RectF	getPageLocationRect(int pageNum) Returns the calculated page rectangle for the given page index.
void	refresh() Recalculates all page rectangles and total content bounds.
CPDFLayoutManager	setPageSizes(java.util.List<android.graphics.RectF> pageSizes) Sets source PDF page sizes used by legacy call sites.
CPDFLayoutManager	setScale(float scale) Sets the zoom scale used by subsequent layout calculations.
CPDFLayoutManager	setScreenVertical(boolean screenVertical) Sets whether the current screen is treated as portrait for legacy call sites.

Methods inherited from class com.compdfkit.ui.reader.CPDFLayoutManager

getPageSpacing, getReaderHeight, getReaderWidth, setPageSpacing

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CPDFSingleLayoutManager

public CPDFSingleLayoutManager()

Creates a single-page layout manager without binding it to a reader view.

The layout inputs should be supplied through CPDFLayoutConfig before refresh() is called.

CPDFSingleLayoutManager

@Deprecated
public CPDFSingleLayoutManager(ReaderView readerView)

Deprecated.

Legacy constructor kept for source compatibility.

The reader view argument is intentionally ignored. New code should use CPDFSingleLayoutManager() and pass all layout inputs through CPDFLayoutConfig.

Parameters:

readerView - ignored legacy reader view reference

Method Detail

setScale

public CPDFLayoutManager setScale(float scale)

Sets the zoom scale used by subsequent layout calculations.

Parameters:

scale - zoom multiplier applied to source page sizes

Returns:

this manager for call chaining

getPageLocationRect

public android.graphics.RectF getPageLocationRect(int pageNum)

Returns the calculated page rectangle for the given page index.

The rectangle is expressed in the paged content coordinate system, not in screen coordinates. An empty rectangle is returned for invalid indexes or before layout is ready.

Parameters:

pageNum - zero-based page index

Returns:

page bounds in content coordinates

getContentWidth

public float getContentWidth()

Returns the total content width calculated by the last refresh() call.

Returns:

paged content width

getContentHeight

public float getContentHeight()

Returns the total content height calculated by the last refresh() call.

Returns:

paged content height

setPageSizes

public CPDFLayoutManager setPageSizes(java.util.List<android.graphics.RectF> pageSizes)

Sets source PDF page sizes used by legacy call sites.

When CPDFLayoutConfig is provided, config page sizes take precedence during refresh().

Parameters:

pageSizes - original PDF page sizes

Returns:

this manager for call chaining

setScreenVertical

public CPDFLayoutManager setScreenVertical(boolean screenVertical)

Sets whether the current screen is treated as portrait for legacy call sites.

When CPDFLayoutConfig is provided, config orientation takes precedence during refresh().

Parameters:

screenVertical - true when the reader screen should use portrait formulas

Returns:

this manager for call chaining

refresh

public void refresh()

Recalculates all page rectangles and total content bounds.

The method copies values from CPDFLayoutConfig, resets cached metrics, prepares page metrics and page pairs, then dispatches to the mode-specific layout method. It updates pageLocations, contentWidth, contentHeight, and the inherited CPDFLayoutResult.