CameraFragmentStandard

public class CameraFragmentStandard extends Fragment implements CameraFragmentInterface, FragmentImplCallback

Component API

CameraFragmentStandard is the main entry point to the Gini Vision Library when using the Component API without the Android Support Library.

It shows a camera preview with tap-to-focus functionality, a trigger button and an optional flash on/off button. The camera preview also shows document corner guides to which the user should align the document.

If instantiated with createInstance then a button for importing documents is shown next to the trigger button. A hint popup is displayed the first time the Gini Vision Library is used to inform the user about document importing.

For importing documents READ_EXTERNAL_STORAGE permission is required and if the permission is not granted the Gini Vision Library will prompt the user to grant the permission. See @{code Customizing the Camera Screen} on how to override the message and button titles for the rationale and on permission denial alerts.

Include the CameraFragmentStandard into your layout either directly with <fragment> in your Activity's layout or using the android.app.FragmentManager and one of the createInstance() methods.

A CameraFragmentListener instance must be available until the CameraFragmentStandard is attached to an activity. Failing to do so will throw an exception. The listener instance can be provided either implicitly by making the hosting Activity implement the CameraFragmentListener interface or explicitly by setting the listener using setListener.

Your Activity is automatically set as the listener in onAttach.

Customizing the Camera Screen

See the CameraActivity for details.

Functions

createInstance

static CameraFragmentStandard createInstance()

static CameraFragmentStandard createInstance(@NonNull() GiniVisionFeatureConfiguration giniVisionFeatureConfiguration)

Factory method for creating a new instance of the Fragment with document import enabled for the specified file types.

dump

void dump(String prefix, FileDescriptor fd, PrintWriter writer, Array<String> args)

equals

final boolean equals(Object o)

getActivity

final Activity getActivity()

@Nullable()

abstract Activity getActivity()

getAllowEnterTransitionOverlap

boolean getAllowEnterTransitionOverlap()

getAllowReturnTransitionOverlap

boolean getAllowReturnTransitionOverlap()

getArguments

final Bundle getArguments()

getChildFragmentManager

final FragmentManager getChildFragmentManager()

getContext

Context getContext()

getEnterTransition

Transition getEnterTransition()

getExitTransition

Transition getExitTransition()

getFragmentManager

final FragmentManager getFragmentManager()

getHost

final Object getHost()

getId

final int getId()

getLayoutInflater

final LayoutInflater getLayoutInflater()

getLoaderManager

LoaderManager getLoaderManager()

getParentFragment

final Fragment getParentFragment()

getReenterTransition

Transition getReenterTransition()

getResources

final Resources getResources()

getRetainInstance

final boolean getRetainInstance()

getReturnTransition

Transition getReturnTransition()

getSharedElementEnterTransition

Transition getSharedElementEnterTransition()

getSharedElementReturnTransition

Transition getSharedElementReturnTransition()

getString

final String getString(int resId)

getTag

final String getTag()

getTargetFragment

final Fragment getTargetFragment()

getTargetRequestCode

final int getTargetRequestCode()

getText

final CharSequence getText(int resId)

getUserVisibleHint

boolean getUserVisibleHint()

getView

View getView()

@Nullable()

abstract View getView()

hashCode

final int hashCode()

hideActivityIndicatorAndEnableInteraction

void hideActivityIndicatorAndEnableInteraction()

Call this method to hide the activity indicator and enable user interaction.

hideCameraTriggerButton

@Deprecated()

~~void~~ ~~hideCameraTriggerButton~~()

Call this method to hide the camera trigger button.

hideDocumentCornerGuides

@Deprecated()

~~void~~ ~~hideDocumentCornerGuides~~()

Call this method to hide the document corner guides.

hideInterface

void hideInterface()

Call this method to hide the interface elements.

instantiate

static Fragment instantiate(Context context, String fname)

isAdded

final boolean isAdded()

isDetached

final boolean isDetached()

isHidden

final boolean isHidden()

isInLayout

final boolean isInLayout()

isRemoving

final boolean isRemoving()

isResumed

final boolean isResumed()

isStateSaved

final boolean isStateSaved()

isVisible

final boolean isVisible()

onActivityCreated

void onActivityCreated(Bundle savedInstanceState)

onActivityResult

void onActivityResult(int requestCode, int resultCode, Intent data)

onAttach

void onAttach(Activity activity)

void onAttach(Context context)

Internal use only.

onAttachFragment

void onAttachFragment(Fragment childFragment)

onConfigurationChanged

void onConfigurationChanged(Configuration newConfig)

onContextItemSelected

boolean onContextItemSelected(MenuItem item)

onCreate

void onCreate(Bundle savedInstanceState)

Internal use only.

onCreateAnimator

Animator onCreateAnimator(int transit, boolean enter, int nextAnim)

onCreateContextMenu

void onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo)

onCreateOptionsMenu

void onCreateOptionsMenu(Menu menu, MenuInflater inflater)

onCreateView

@Nullable()

View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

Internal use only.

onDestroy

void onDestroy()

Internal use only.

onDestroyOptionsMenu

void onDestroyOptionsMenu()

onDestroyView

void onDestroyView()

onDetach

void onDetach()

onGetLayoutInflater

LayoutInflater onGetLayoutInflater(Bundle savedInstanceState)

onHiddenChanged

void onHiddenChanged(boolean hidden)

onInflate

void onInflate(AttributeSet attrs, Bundle savedInstanceState)

onLowMemory

void onLowMemory()

onMultiWindowModeChanged

void onMultiWindowModeChanged(boolean isInMultiWindowMode, Configuration newConfig)

onOptionsItemSelected

boolean onOptionsItemSelected(MenuItem item)

onOptionsMenuClosed

void onOptionsMenuClosed(Menu menu)

onPause

void onPause()

onPictureInPictureModeChanged

void onPictureInPictureModeChanged(boolean isInPictureInPictureMode, Configuration newConfig)

onPrepareOptionsMenu

void onPrepareOptionsMenu(Menu menu)

onRequestPermissionsResult

void onRequestPermissionsResult(int requestCode, Array<String> permissions, Array<int> grantResults)

onResume

void onResume()

Internal use only.

onSaveInstanceState

void onSaveInstanceState(@NonNull() Bundle outState)

Internal use only.

onStart

void onStart()

Internal use only.

onStop

void onStop()

Internal use only.

onTrimMemory

void onTrimMemory(int level)

onViewCreated

void onViewCreated(View view, Bundle savedInstanceState)

onViewStateRestored

void onViewStateRestored(Bundle savedInstanceState)

postponeEnterTransition

void postponeEnterTransition()

registerForContextMenu

void registerForContextMenu(View view)

requestPermissions

final void requestPermissions(Array<String> permissions, int requestCode)

setAllowEnterTransitionOverlap

void setAllowEnterTransitionOverlap(boolean allow)

setAllowReturnTransitionOverlap

void setAllowReturnTransitionOverlap(boolean allow)

setArguments

void setArguments(Bundle args)

setEnterSharedElementCallback

void setEnterSharedElementCallback(SharedElementCallback callback)

setEnterTransition

void setEnterTransition(Transition transition)

setExitSharedElementCallback

void setExitSharedElementCallback(SharedElementCallback callback)

setExitTransition

void setExitTransition(Transition transition)

setHasOptionsMenu

void setHasOptionsMenu(boolean hasMenu)

setInitialSavedState

void setInitialSavedState(Fragment.SavedState state)

setListener

void setListener(@NonNull() CameraFragmentListener listener)

Set a listener for camera events.

setMenuVisibility

void setMenuVisibility(boolean menuVisible)

setReenterTransition

void setReenterTransition(Transition transition)

setRetainInstance

void setRetainInstance(boolean retain)

setReturnTransition

void setReturnTransition(Transition transition)

setSharedElementEnterTransition

void setSharedElementEnterTransition(Transition transition)

setSharedElementReturnTransition

void setSharedElementReturnTransition(Transition transition)

setTargetFragment

void setTargetFragment(Fragment fragment, int requestCode)

setUserVisibleHint

void setUserVisibleHint(boolean isVisibleToUser)

shouldShowRequestPermissionRationale

boolean shouldShowRequestPermissionRationale(String permission)

showActivityIndicatorAndDisableInteraction

void showActivityIndicatorAndDisableInteraction()

Call this method to show an activity indicator and disable user interaction.

showAlertDialog

void showAlertDialog(@NonNull() String message, @NonNull() String positiveButtonTitle, @NonNull() DialogInterface.OnClickListener positiveButtonClickListener, @Nullable() String negativeButtonTitle, @Nullable() DialogInterface.OnClickListener negativeButtonClickListener, @Nullable() DialogInterface.OnCancelListener cancelListener)

showCameraTriggerButton

@Deprecated()

~~void~~ ~~showCameraTriggerButton~~()

Call this method to show the camera trigger button.

showDocumentCornerGuides

@Deprecated()

~~void~~ ~~showDocumentCornerGuides~~()

Call this method to show the document corner guides.

showError

void showError(@NonNull() String message, int duration)

Call this method to show an error message to the user in the Camera Screen.

showInterface

void showInterface()

Call this method to show the interface elements.

startActivity

void startActivity(Intent intent)

abstract void startActivity(Intent intent)

startActivityForResult

void startActivityForResult(Intent intent, int requestCode)

abstract void startActivityForResult(Intent intent, int requestCode)

startIntentSenderForResult

void startIntentSenderForResult(IntentSender intent, int requestCode, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)

startPostponedEnterTransition

void startPostponedEnterTransition()

toString

String toString()

unregisterForContextMenu

void unregisterForContextMenu(View view)