ImageCoverFlow

by dolphinwang

dolphinwang /ImageCoverFlow

To show coverflow effect on android

449 Stars 137 Forks Last release: Not found 8 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

ImageCoverFlow

To show Cover Flow effect on Android

ImageCoverFlow is an open source Android library that allows developers to easily create applications with a cover flow effect to show images. This library does not extend Gallery. Feel free to use it all you want in your Android apps provided that you cite this project and include the license in your app.

Oops! The screenshot is missing!

ImageCoverFlow is currently used in some published Android apps:

  1. ICardEnglish
  2. PNP iSerbis

How to Use:

Step One: Add
CoverFlowView
to your project

  1. Via XML:

  1. Programatically (via Java):
CoverFlowView mCoverFlowView =
    (CoverFlowView) findViewById(R.id.coverflow);

mCoverFlowView.setCoverFlowGravity(CoverFlowGravity.CENTER_VERTICAL); mCoverFlowView.setCoverFlowLayoutMode(CoverFlowLayoutMode.WRAP_CONTENT); mCoverFlowView.setReflectionHeight(30); mCoverFlowView.setReflectionGap(20); mCoverFlowView.setVisibleImage(5);


Step Two: Set an adapter, which extends
CoverFlowAdapter
:

MyCoverFlowAdapter adapter = new MyCoverFlowAdapter(this);
mCoverFlowView.setAdapter(adapter);

TIPS: * Method

setAdapter()
should be called after all properties of CoverFlow are settled. * If you want to load image dynamically, you can call method
notifyDataSetChanged()
when bitmaps are loaded.

Step Three: if you want to listen for the click event of the top image, you can set a
StateListener
to it:

mCoverFlowView.setStateListener(new CoverFlowView.StateListener() {
    @Override
    public void imageOnTop(CoverFlowView view, int position,
            float left, float top, float right,float bottom) {
        // TODO
    }

@Override
public void invalidationCompleted(CoverFlowView view) {
    // TODO
}

});

if you want to listen for click events of showing images, you can set a

ImageClickListener
to it:
mCoverFlowView.setImageClickListener(new CoverFlowView.ImageClickListener() {
            @Override
            public void onClick(CoverFlowView coverFlowView, int position) {
                // TODO
            }
});

If you want to listen for long click events of the top image, you can set a

ImageLongClickListener
to it:
mCoverFlowView
    .setImageLongClickListener(new CoverFlowView.ImageLongClickListener() {
        @Override
        public void onLongClick(CoverFlowView view, int position) {
            // TODO
        }
    });

Users can use method

setSelection(int position)
to show a specific position at the top.

If you want to subclass
CoverFlowView

  1. You can override method
    getCustomTransformMatrix()
    to make more transformations for images (there is some annotated code which shows how to make image y-axis rotation).
  2. You should never override method
    onLayout()
    to layout any of
    CoverFlowView
    ’s children, because all of image will draw on the canvas directly.

Developed By:

Roy Wang ([email protected])

If you use this library, please let me know.


License:

Copyright 2013 Roy Wang

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.