get active item id

The title says it all:
Is there any API method (GalleryCoreApi) to receive the itemID of the active (currently viewed) album/photo?

Thanks for your fast reply. But I was actually not talking about the theme layer, {$theme.item.id} doesnt help. I'm trying to get the active itemID in embedded mode (but also tried from a module) to trigger a custom operation based on the current item id. I already tried the 'fetchItemIdByPath()' method, but I'm always getting an error from it (what is 'a complete logical path' (from api docs) in this context?) ... Is the item id stored in a variable? Can I use the getPluginParameter method?

- GalleryEmbed::handleRequest() returns 'themeData' which includes the itemId
- @GalleryCoreApi::fetchItemIdByPath():
you can use it like: list ($ret, $id) = GalleryCoreApi::fetchItemIdByPath('albumA/subAlbumB/fileC.jpg');

not sure if it needs a leading slash or not, you'll find out.
it will return a ERROR_MISSING_OBJECT error if the path doesn't resolve to any item. else it returns the id of the item at that path.

--------------
Documentation: Support / Troubleshooting | Installation, Upgrade, Configuration and Usage

I just wanted to share my 2cent code for that one and follow up with a question... In an embedded environment, to set the title, I use the following code which displays the name of the album in the title (if it's an album, it just takes it, if it's an image it looks for its parent).

[code]
$g2moddata = GalleryEmbed::handleRequest();
if ($g2moddata['themeData']['item']['canContainChildren']) {
$pageTitle = $title;
} else {
$curPar = end($g2moddata['themeData']['parents']);
$pageTitle = $curPar['title'];
}
[code]

concerning fetchItemIdByPath, is there also a function doing the opposite? I would like to link to my images from outside and I can look up the ID from the database but then I would like to do a redirect to the "speaking" url, not to the id driven one...

cheers
MU